POST /v1/data/ycombinator/companies/run
Pricing: $0.01 per companie ($10.00 per 1,000).
Filter the directory by batch, industry, region, tag, status or keyword, or pass company page URLs (or bare slugs) to look up specific companies.
Ways to call it
- Filter the directory (optional:
batch,industry,subindustry,region,tag,status,top_company,is_hiring, …) - By URL: set
urls
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Company page URLs (https://www.ycombinator.com/companies/<slug>) or bare slugs. Slugs are lowercase - the site 404s on any other casing.
YC batch, e.g.
W25 or Winter 2025 - both spellings work. The list is YC’s own; any other spelling can still be sent through the API.51 allowed values, for example Summer 2027, Winter 2027, Fall 2026, Summer 2026, Spring 2026, Winter 2026, Fall 2025, Summer 2025, Spring 2025, Winter 2025. Fetch the full list with GET /v1/data/ycombinator/companies?expand=options.Top-level industry, e.g.
Healthcare, B2B, Consumer.59 allowed values, for example Agriculture, Analytics, Apparel and Cosmetics, Asset Management, Automotive, Aviation and Space, B2B, Banking and Exchange, Climate, Construction. Fetch the full list with GET /v1/data/ycombinator/companies?expand=options.Narrower industry, in YC’s arrow form, e.g.
Fintech -> Payments. The leaf alone (Payments) works when only one industry has it.59 allowed values, for example B2B, B2B -> Analytics, B2B -> Engineering, Product and Design, B2B -> Finance and Accounting, B2B -> Human Resources, B2B -> Infrastructure, B2B -> Legal, B2B -> Marketing, B2B -> Office Management, B2B -> Operations. Fetch the full list with GET /v1/data/ycombinator/companies?expand=options.A company tag in YC’s own spelling, e.g.
AI, SaaS, Developer Tools. A tag YC does not use is refused with the closest real ones.Stop after this many companies. Each one costs a row, so this caps the bill as well as the output. Omitted means every match.
Example
Response fields
Each row indata is one companie, keyed by these fields.