---
title: "Search entities"
method: GET
path: "/search"
tags: ["Search"]
---

# Search entities

`GET /search`

## Request

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

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.

## Query parameters

- `sector` string
- `keyword` string
- `q` string
- `entity_type` string
- `limit` integer
- `offset` integer
- `scope` string
- `include_founders` 'true' | 'false'
- `max_credits` integer

## Response `200`

Search results (companies ranked first).

- object
  - `filters` object
    - `sector` string
    - `keyword` string
    - `entity_type` string
  - `total` integer
  - `returned` integer
  - `offset` integer
  - `has_more` boolean
  - `results` object[]
    - `twitter_user_id` string
    - `username` string
    - `description` string
    - `classification` Classification: AI classification of the entity.
      - `is_company` boolean: Whether the entity is classified as a company.
      - `confidence` string: Classification confidence.
      - `sector` string: Primary sector (e.g. "AI/ML", "DeFi").
      - `entity_type` string: Entity type (e.g. "startup", "investor").
  - `cost_credits` integer: Credits charged for this call.
  - `balance_credits` integer: Remaining credit balance after this call.
  - `max_cost_credits` integer: 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_included` boolean: Present when include_founders=true was honored.
  - `starter_results` object[]: Up to 25 starter rows, source "starter", from the whole Frontrun network, not your tracked accounts.
  - `starter_note` string

## 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.

## Changes

- **2026-10-19** `6880b29e94c9`: 1 breaking
  - removed the enum value `catalog` from the `query` request parameter `scope`

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/search/get.md)

---

[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)