# GET /v1/search/thesis

> Source: https://www.frontrun.vc/docs/endpoints/thesis-search
> Raw markdown: https://www.frontrun.vc/raw/docs/endpoints/thesis-search.md
> Full docs (single file): https://www.frontrun.vc/llms-full.txt

Semantic search over **your database** - every company the investors you track have surfaced. Describe an investment thesis in plain text and 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:** Draws on your monthly usage.

```bash
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 accounts first surfaced it), and `convergence_count` (how many tracked accounts follow it) - help you prioritize which matches to dig into.

```json
{
  "query": "information markets - platforms where people trade on what they know",
  "returned": 25,
  "usage_pct": 12,
  "usage_resets_at": "2026-11-01T00:00:00Z",
  "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`](/docs/endpoints/company) to pull a full overview of any match, or [`GET /v1/company/:handle/signals`](/docs/endpoints/company-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.