ycombinator.com APIycombinator.com ↗
Access YC company profiles, founder data, partner bios, job listings, and the YC library via 7 structured endpoints. Filter by batch, industry, and hiring status.
curl -X GET 'https://api.parse.bot/scraper/303993f2-6efa-4ab4-9310-f02643b002a4/search_companies?page=0&batch=Winter%2B2025&limit=5&query=fintech' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for YC companies with filters for batch, industry, hiring status, and top company status. On empty search, returns a default paginated list of companies.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| batch | string | Filter by YC batch (e.g., 'Winter 2024', 'Summer 2023') |
| limit | integer | Number of results per page |
| query | string | Search keyword to filter companies |
| industry | string | Filter by industry (e.g., 'Fintech', 'B2B', 'Consumer') |
| is_hiring | string | Filter by hiring status ('true' or 'false') |
| top_company | string | Filter for top companies ('true' or 'false') |
{
"type": "object",
"fields": {
"hits": "array of company objects with name, slug, batch, industry, one_liner, website, team_size, and more",
"page": "integer - current page number",
"nbHits": "integer - total matching results",
"nbPages": "integer - total pages available",
"hitsPerPage": "integer - results per page"
},
"sample": {
"data": {
"hits": [
{
"id": 29798,
"name": "&AI",
"slug": "ai-2",
"batch": "Summer 2024",
"status": "Active",
"website": "https://www.tryandai.com/",
"industry": "B2B",
"isHiring": false,
"one_liner": "Collaborative workspace for patent litigators",
"team_size": 13,
"top_company": false
}
],
"page": 0,
"nbHits": 2744,
"nbPages": 50,
"hitsPerPage": 20
},
"status": "success"
}
}About the ycombinator.com API
The Y Combinator API covers 7 endpoints that expose YC company directories, founder profiles, partner bios, and job listings from workatastartup.com. The search_companies endpoint alone returns fields like batch, industry, team_size, one_liner, and website, and accepts filters for batch cohort, hiring status, and top-company designation. Pagination is supported across company, founder, and job search endpoints.
Company Data
The search_companies endpoint accepts up to seven parameters — including batch (e.g., Winter 2024), industry (e.g., Fintech, B2B), is_hiring, and top_company — and returns paginated result sets with nbHits, nbPages, and hitsPerPage metadata alongside each company's name, slug, one_liner, website, and team_size. For full detail on a single company, get_company takes a slug and returns founders (with full_name, title, founder_bio, and social URLs), long_description, tags, and batch.
Founders and Partners
search_founders provides a keyword-searchable index of YC founders, returning first_name, last_name, current_company, current_title, company_slug, and batches. get_partners lists all current YC partners with name, title, bio, photo, and url. To go deeper on a partner, get_person_detail accepts a partner slug (obtained from get_partners) and returns bio, stats, companies, twitter_handle, and linkedin_handle. Note that this endpoint only resolves YC partner slugs, not founder slugs.
Jobs and Library
search_jobs queries job listings across YC companies from workatastartup.com. It filters by role category (e.g., software-engineer, designer, product) and returns up to 30 jobs per page, each with title, type, location, role_category, salary, company_name, company_slug, company_batch, and company_description. get_library returns the YC content library structured as a featured item and an array of carousels, covering articles, videos, and podcasts.
- Build a YC batch directory that lists all companies from a specific cohort with team size and one-liner descriptions.
- Track which YC companies are actively hiring by filtering
search_companieswithis_hiring=true. - Aggregate job listings by role category across all YC portfolio companies using
search_jobs. - Generate a founder graph by cross-referencing
search_foundersresults withget_companyfounder arrays. - Populate a partner profile page using
get_partnersandget_person_detailwith bio, stats, and associated companies. - Monitor new YC companies entering a given industry vertical by querying
search_companieswith theindustryfilter. - Curate a reading list of YC content by fetching articles and videos from the
get_librarycarousels.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Y Combinator have an official public developer API?+
What does `get_person_detail` return, and does it work for founders?+
bio, stats array, associated companies, twitter_handle, and linkedin_handle. The endpoint only resolves slugs for YC partners (e.g., garry-tan, michael-seibel). Founder slugs are not supported at this endpoint — founder data is available through search_founders and the founders array within get_company.Does the API expose funding amounts or valuation data for YC companies?+
How does pagination work across search endpoints?+
search_companies, search_founders, and search_jobs all use 0-indexed page parameters. The response includes nbHits (total matching records), nbPages (total pages), and hitsPerPage (results per page), so you can walk through the full result set programmatically.Can I filter job listings by location or salary range?+
search_jobs endpoint currently accepts a role category filter and returns location and salary fields in each job object, but does not accept location or salary as input filter parameters. You can fork it on Parse and revise to add those filters if your use case requires narrowing results by geography or compensation.