GET /v1/trending
Entities ranked by the number of tracked accounts that recently followed them.
Cost: Draws on your monthly usage (more with classify=true, per classified entity).
curl "https://frontrun.vc/v1/trending?since=7d&classify=true" \
-H "X-API-Key: your_api_key"Startups only
Trending returns startups only, ranked by how many of your tracked accounts followed each one in the window (no minimum). A result is kept only if our curated companies table marks it as 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. Anything not yet classified is left out, so a startup can take a little time to appear.
classify=true attaches the cached classification to each result (adds usage per entity). For the full catalog of your companies, call GET /v1/companies.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string (query) | "7d" | Time window. Accepts "24h", "48h", "168h", "7d", "14d", "30d", or ISO date. Defaults to 7d when omitted. |
limit | integer (query) | 25 | Maximum results (max 100). |
offset | integer (query) | 0 | Pagination offset. |
classify | string (query) | -- | Set to "true" to attach cached AI classification to each result. Adds usage per classified entity. |
max_credits | integer (query) | -- | Optional spend ceiling for this call; with classify=true usage scales with limit. Fails closed: over the ceiling, nothing runs and nothing is charged. See Budgets & Cursors. |
/v1/trending does not take a cursor. It is a ranked aggregation over a
window, not a record listing, so narrowing the window changes the answer rather
than continuing it. Use since.
Response
{
"since": "2026-02-28T00:00:00.000Z",
"accounts_scanned": 50,
"total": 25,
"usage_pct": 12,
"usage_resets_at": "2026-11-01T00:00:00Z",
"trending": [
{
"twitter_user_id": "1111111111",
"username": "stealth_ai_co",
"name": "StealthAI",
"description": "Automating enterprise workflows with LLMs",
"verified": true,
"followed_by": ["pmarca", "naval", "paulg", "sequoia"],
"follower_count": 4,
"classification": {
"is_company": true,
"confidence": "high",
"sector": "AI/ML",
"entity_type": "startup"
}
}
]
}