GET /v1/search/thesis

Semantic search over the company catalog. Describe an investment thesis in plain text — the API matches companies by meaning, not exact words. A thesis about "information markets" surfaces companies describing themselves as prediction protocols, forecasting tools, or event contracts, even if they never use your phrasing.

Cost: 40 credits per call

curl -G "https://frontrun.vc/v1/search/thesis" \
  --data-urlencode "q=information markets — platforms where people trade on what they know" \
  -H "X-API-Key: your_api_key"

Parameters

Parameter	Type	Default	Description
`q`	string (query)	required	Your thesis in plain text (min 10 characters). A sentence or short paragraph works best — more specific theses return sharper matches.
`limit`	integer (query)	`25`	Maximum results (max 50).

Response

Results are ranked by similarity (0–1, cosine similarity between your thesis and the company's description). Signal fields — followers_count, first_flagged_at (when tracked VCs first surfaced it), and convergence_count (how many tracked VCs follow it) — help you prioritize which matches to dig into.

{
  "query": "information markets — platforms where people trade on what they know",
  "returned": 25,
  "cost_credits": 40,
  "balance_credits": 9860,
  "results": [
    {
      "username": "example_protocol",
      "name": "Example Protocol",
      "description": "Prediction markets for real-world events",
      "website": "https://example.xyz",
      "sector": "Crypto/Web3",
      "entity_type": "startup",
      "followers_count": 842,
      "first_flagged_at": "2026-06-12T08:30:00Z",
      "convergence_count": 3,
      "similarity": 0.61
    }
  ]
}

Tips

Write the thesis the way you'd explain it to a partner, not as keywords. "Tools that let anyone underwrite risk on real-world outcomes" beats "prediction market".
Combine with GET /v1/company/:handle to pull a full overview of any match, or GET /v1/company/:handle/signals to see who's following it.
Similarity above ~0.5 is a strong conceptual match; 0.3–0.5 is adjacent territory worth scanning.

GET /v1/search Custom Classification