GET /v1/reports
Daily reports of newly found startups, for a date range. There are two reports:
report | What it is | Plan |
|---|---|---|
network | The Frontrun Report. Every new startup found across the whole Frontrun network that day. | Pro and Max (trials included) |
list | The report from only the accounts you track. | Every plan |
Leave report out and you get the one your account is emailed each morning: the Frontrun Report for accounts that started on it, your tracked-accounts report for everyone else. The response's report field says which one you got.
Cost: Draws on your monthly usage.
# The Frontrun Report, last 7 days
curl "https://frontrun.vc/v1/reports?report=network&since=7d" \
-H "X-API-Key: your_api_key"
# Only what your tracked accounts found
curl "https://frontrun.vc/v1/reports?report=list&since=7d" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
report | string (query) | your emailed report | "network" (the Frontrun Report, whole network) or "list" (your tracked accounts). |
since | string (query) | "7d" | How far back to fetch. Values: "7d", "14d", or a start date "YYYY-MM-DD". Ignored if date is set. |
date | string (query) | -- | Fetch a single report for this date (YYYY-MM-DD). |
sector | string (query) | -- | Filter companies by sector, description, or name. Case-insensitive partial match. |
limit | integer (query) | 7 | Maximum reports returned (max 30). |
cursor | string (query) | -- | Opaque watermark from a previous response's next_cursor. Walks forward from the day after the newest report you already received. Cannot be combined with date. See Budgets & Cursors. |
Response
{
"reports": [
{
"date": "2026-07-07",
"is_sample": false,
"total_companies": 2,
"companies": [
{
"handle": "stealth_ai_co",
"name": "StealthAI",
"sector": "AI/ML",
"description": "Automating enterprise workflows with LLMs",
"confidence": "high",
"tracked_by": ["pmarca", "naval"],
"website": "https://stealthai.com",
"profile_image": "https://pbs.twimg.com/profile_images/..."
}
]
}
],
"total_reports": 1,
"total_companies": 2,
"filter": null,
"usage_pct": 12
}| Field | Type | Description |
|---|---|---|
report | string | "network" or "list": which report this is. report_note says how to get the other one. |
reports | array | One entry per daily report, newest first. |
reports[].is_sample | boolean | true for the two platform sample reports gifted at signup. Their companies are real but did not come from your tracked accounts, so skip them when you want only your own discoveries. |
reports[].companies | array | Companies discovered in that report. |
tracked_by | string[] | Your tracked accounts that followed the company. |
section | string | network only. "new" (found this week) or "converging" (a known company gaining tracked follows). |
tracked_by_count | integer | network only. How many accounts in the network followed it. |
first_seen | string | network only. When Frontrun first found the company. |
in_your_sectors | boolean | network only. true when the company is in the sectors you picked in onboarding. |
total_reports | integer | Number of reports returned. |
total_companies | integer | Companies across all returned reports. |
filter | string | The sector filter applied, or null. |