Search

Search entities

Changed on

Keyword and metadata search across every entity your tracked accounts follow (the full stored follow graph, not just recent follows). At least one of sector, keyword (alias q), or entity_type is required, otherwise the call fails with 400. All filters are case-insensitive substring matches; companies are ranked first in results. Costs 4 credits. For meaning-based matching (concepts, not substrings) use /search/thesis. Account keys also get starter_results (plus starter_note): up to 25 matches for the same q and sector from your 30-day starter set in your sectors, each with source "starter", deduped against and kept apart from results (your own). Default mode and scope=catalog, first page (offset 0) only. Not added when entity_type or follower bounds (min_followers / max_followers) are set.

get/search

Request

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

Query parameters

sectorstring

Sector filter (case-insensitive substring match, e.g. "AI"). Data-driven vocabulary, not a fixed enum: call GET /v1/sectors to discover the exact sector strings present in your coverage.

keywordstring

Keyword matched against username, sector, and bio.

qstring

Alias for keyword.

entity_typestring

Entity type filter. Data-driven vocabulary, not a fixed enum: call GET /v1/sectors to discover the values in your coverage (e.g. "company", "person", "project", "vc_firm"). Case-insensitive substring match under the default scope=tracked; exact match under scope=catalog.

limitinteger

Maximum results to return (default 50, max 200).

offsetinteger

Pagination offset (default 0).

scopestring
Example:catalog

catalog = keyword search over your company catalog. Otherwise whose follows to search: tracked (default), network (whole Frontrun network; paid Pro and Enterprise) or list:<id> (one of your lists).

include_founders'true' | 'false'

scope=catalog only. Set to "true" to join cached founders onto each result so company plus founders is ONE call. Adds 100 credits per company that resolves; companies with no cached founders are free. Pair with max_credits, since the ceiling scales with limit.

max_creditsinteger

Ceiling on what this single call may cost, in credits. FAILS CLOSED: checked against the maximum the call could cost before any billable work runs, so if it would exceed the ceiling nothing is computed and nothing is charged (400, error_code max_credits_exceeded, with max_cost_credits telling you the real number). You are still billed only for what was actually computed, so a call that clears the ceiling usually lands under it. Relevant here because scope=catalog with include_founders=true adds 100 credits per company that resolves, so limit=200 has a 20,004 credit ceiling.

Response

Search results (companies ranked first).

totalinteger
returnedinteger
offsetinteger
has_moreboolean
cost_creditsinteger

Credits charged for this call.

balance_creditsinteger

Remaining credit balance after this call.

max_cost_creditsinteger

The most this call could have cost with the parameters you sent. Budget the next call against it. cost_credits is what you were actually charged.

founders_includedboolean

Present when include_founders=true was honored.

starter_resultsobject[]

Up to 25 starter rows, source "starter", from the whole Frontrun network, not your tracked accounts.

starter_notestring

Changes