Skip to main content
POST /v1/data/ycombinator/founders/run Pricing: $0.01 per founder ($10.00 per 1,000). Filter by batch, founder title, industry, region or keyword. The URL mode takes founder slugs returned by a previous run.

Ways to call it

  • Filter the directory (optional: batch, title, industry, parent_industry, subindustry, region, top_company, query, …)
  • By URL: set urls

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Founder slugs from a previous run’s ycUrl or urlSlug. YC has no standalone founder page, so these cannot be copied out of a browser.
string
YC batch, e.g. W25 or Winter 2025.50 allowed values, for example S27 (Summer 2027), W27 (Winter 2027), F26 (Fall 2026), S26 (Summer 2026), P26 (Spring 2026), W26 (Winter 2026), F25 (Fall 2025), S25 (Summer 2025), P25 (Spring 2025), W25 (Winter 2025). Fetch the full list with GET /v1/data/ycombinator/founders?expand=options.
string
Founder title, e.g. CTO, CEO.
string
Industry of the founder’s company.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/founders?expand=options.
string
Top-level industry, e.g. B2B.Allowed values: B2B, Consumer, Education, Fintech, Government, Healthcare, Industrials, Real Estate and Construction, Unspecified.
string
Narrower industry, in YC’s arrow form, e.g. Consumer -> Food and Beverage. The form narrows it by Parent industry; the API accepts it on its own.59 allowed values, for example B2B, B2B -> Analytics (Analytics), B2B -> Engineering, Product and Design (Engineering, Product and Design), B2B -> Finance and Accounting (Finance and Accounting), B2B -> Human Resources (Human Resources), B2B -> Infrastructure (Infrastructure), B2B -> Legal (Legal), B2B -> Marketing (Marketing), B2B -> Office Management (Office Management), B2B -> Operations (Operations). Fetch the full list with GET /v1/data/ycombinator/founders?expand=options.
string
e.g. United States of America.
boolean
Only founders of YC top companies.
string
Free-text search across founders.
integer
Stop after this many founders. 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 founder, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
The whole 2020+ founder list with emails is free in one call via ycombinator/founders-dataset.