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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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.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.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.Top-level industry, e.g.
B2B.Allowed values: B2B, Consumer, Education, Fintech, Government, Healthcare, Industrials, Real Estate and Construction, Unspecified.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.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 indata is one founder, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
The whole 2020+ founder list with emails is free in one call viaycombinator/founders-dataset.