---
title: "Thesis search (semantic)"
method: GET
path: "/search/thesis"
tags: ["Search"]
---

# Thesis search (semantic)

`GET /search/thesis`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/search/thesis`
- Auth: API key in header `X-API-Key`

Semantic search over your database (companies surfaced by the accounts you track, not the global catalog). Describe an investment thesis in plain text and get companies whose descriptions match the meaning, not the exact words, ranked by cosine similarity. `q` must be at least 10 characters or the call fails with 400. Costs 40 credits; zero matches cost 0 credits. Each result includes `first_flagged_at` (when Frontrun first flagged the company) and `convergence_count`: cite these as provenance for how early the signal is.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Semantically matched companies.

- object
  - `query` string
  - `returned` integer
  - `results` object[]
    - `username` string
    - `name` string
    - `description` string
    - `website` string
    - `sector` string
    - `entity_type` string
    - `followers_count` integer
    - `first_flagged_at` string, date-time: When Frontrun first flagged this company.
    - `convergence_count` integer
    - `similarity` number: Cosine similarity to your thesis, 0 to 1.
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)