Docs
API Reference
GET /v1/reports

GET /v1/reports

Daily reports of newly found startups, for a date range. There are two reports:

reportWhat it isPlan
networkThe Frontrun Report. Every new startup found across the whole Frontrun network that day.Pro and Max (trials included)
listThe 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

ParameterTypeDefaultDescription
reportstring (query)your emailed report"network" (the Frontrun Report, whole network) or "list" (your tracked accounts).
sincestring (query)"7d"How far back to fetch. Values: "7d", "14d", or a start date "YYYY-MM-DD". Ignored if date is set.
datestring (query)--Fetch a single report for this date (YYYY-MM-DD).
sectorstring (query)--Filter companies by sector, description, or name. Case-insensitive partial match.
limitinteger (query)7Maximum reports returned (max 30).
cursorstring (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
}
FieldTypeDescription
reportstring"network" or "list": which report this is. report_note says how to get the other one.
reportsarrayOne entry per daily report, newest first.
reports[].is_samplebooleantrue 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[].companiesarrayCompanies discovered in that report.
tracked_bystring[]Your tracked accounts that followed the company.
sectionstringnetwork only. "new" (found this week) or "converging" (a known company gaining tracked follows).
tracked_by_countintegernetwork only. How many accounts in the network followed it.
first_seenstringnetwork only. When Frontrun first found the company.
in_your_sectorsbooleannetwork only. true when the company is in the sectors you picked in onboarding.
total_reportsintegerNumber of reports returned.
total_companiesintegerCompanies across all returned reports.
filterstringThe sector filter applied, or null.