---
title: "Trending startups"
method: GET
path: "/trending"
tags: ["Signal"]
---

# Trending startups

`GET /trending`

## Request

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

Startups ranked by how many of your tracked accounts followed them within the window (no minimum). Startups only: A result is kept only if our curated companies table marks it a company, its entity type is company, project, protocol or product, and it has at most 25,000 X followers (the same ceiling the daily reports use). People, investors, VC firms, media, organizations, public companies and big established brands are left out, as is anything not yet classified. Costs 24 credits. classify=true attaches the cached AI classification to each result (16 credits per classified entity returned), so keep `limit` small when classifying. Default window is 7d when since is omitted. Returns an empty hint response if you track no accounts; add coverage with POST /track first.

## Query parameters

- `since` string
- `limit` integer
- `offset` integer
- `classify` 'true' | 'false'
- `max_credits` integer
- `scope` string

## Response `200`

Trending entities.

- object
  - `since` string, date-time
  - `accounts_scanned` integer
  - `total` integer
  - `returned` integer
  - `offset` integer
  - `has_more` boolean
  - `trending` object[]
    - `twitter_user_id` string
    - `username` string
    - `name` string
    - `description` string
    - `verified` boolean
    - `followed_by` string[]
    - `follower_count` integer: Number of tracked accounts that followed this entity in the window.
    - `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.

## 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 info
  - added the new optional `query` request parameter `scope`

[Operation history](https://skmtc.dev/frontrun/apis/frontrun-api/changes/trending/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)