Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Company page URLs (https://www.ycombinator.com/companies/<slug>) or bare slugs. Slugs are lowercase - the site 404s on any other casing.
string
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.
string
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.
string
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.
string
e.g. United States of America, India.
string
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.
string
Active, Acquired, Public or Inactive.
boolean
Only YC’s own top-company list.
boolean
Only companies with open roles.
boolean
Only nonprofits.
string
Free-text search across the directory.
integer
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 in data is one companie, keyed by these fields.

Example response

Abridged: long text and lists are shortened.