startups.rip APIstartups.rip ↗
Access data on 1,700+ Y Combinator startups via 5 endpoints. Search companies, browse batches, get status, founders, and full research reports.
curl -X GET 'https://api.parse.bot/scraper/3876c01f-dff8-4fd4-bd20-51dcd34ebaf0/search_companies?limit=5&query=airbnb' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for YC startups by keyword. Returns up to 20 matching companies with basic info including name, batch, category, status, and one-liner.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results to return (server caps at 20). |
| queryrequired | string | Search keyword (e.g., 'airbnb', 'marketplace', 'fintech') |
{
"type": "object",
"fields": {
"count": "number of results returned",
"query": "search keyword echoed back",
"results": "array of company objects with id, slug, name, batch, oneLiner, founders, category, foundedYear, status, is_free, isFreeReport, isLocked"
},
"sample": {
"data": {
"count": 5,
"query": "airbnb",
"results": [
{
"id": "1",
"name": "Airbnb",
"slug": "airbnb",
"batch": "Winter 2009",
"status": "public",
"is_free": false,
"category": "Marketplace",
"founders": [],
"isLocked": true,
"oneLiner": "Book accommodations around the world.",
"foundedYear": 2020,
"isFreeReport": false
}
]
},
"status": "success"
}
}About the startups.rip API
The startups.rip API provides structured access to data on over 1,700 Y Combinator startups across 5 endpoints, covering company status, batch membership, founder details, and multi-section research reports. The get_company endpoint returns the most detail, including named report sections such as Overview, Founding Story, Timeline, Post-Mortem, and Key Lessons. The list_batches endpoint enumerates all 40 YC cohorts from Summer 2005 through Spring 2025 along with 145 company categories.
What the API Covers
The API indexes Y Combinator portfolio companies and surfaces structured data about their lifecycle — whether active, acquired, or defunct. Each company record includes a slug, batch, status, category, one_liner, founders_text, and a logo_url. The get_company endpoint also returns report_sections, an object mapping section names (Overview, Founding Story, Business Model, Market Position, Traction, Post-Mortem, Key Lessons, etc.) to full narrative text. Not every company has a complete report; the has_complete_analysis field on list results signals whether the full set of sections is available.
Searching and Browsing
The search_companies endpoint accepts a query string and returns up to 20 matching companies with id, slug, name, batch, oneLiner, category, status, and foundedYear. There is no pagination — results are capped server-side at 20 per query. The list_companies_by_batch endpoint accepts a batch parameter (e.g., 'Winter 2019') exactly as returned by list_batches, and returns the full company roster for that cohort including slug, name, batch_short, status, category, and logo_url. Older batches may have reduced coverage.
Similarity and Discovery
The get_similar_companies endpoint takes a company slug and a category string and returns companies the site considers related. Both parameters are required and the category must match a value from the list_batches categories array. Results include id, slug, name, batch, oneLiner, category, status, logoUrl, is_free, and has_complete_analysis. This endpoint is useful for clustering companies by vertical or finding comparable peers within a cohort.
- Build a YC startup tracker that flags status changes (Active → Acquired → Inactive) across batches using
list_companies_by_batchandget_company. - Aggregate post-mortem and Key Lessons report sections from defunct startups to study common failure patterns.
- Generate category-level startup maps by querying
list_batchescategories and then fetching companies per batch filtered by category. - Surface peer companies for competitive research using
get_similar_companieswith a target slug and matching category. - Index YC founders by name using the
founders_textfield returned fromget_companyto cross-reference founders across multiple startups. - Build a cohort comparison tool by pulling Business Model and Traction report sections for all companies in a given YC batch.
- Create a search interface for YC startups by keyword using
search_companieswith terms like 'fintech', 'marketplace', or 'healthcare'.
| 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 startups.rip have an official developer API?+
What does the `get_company` endpoint return beyond basic company info?+
name, batch, status, category, one_liner, founders_text, and logo_url, it returns report_sections — an object keyed by section name (e.g., Overview, Founding Story, Timeline, What They Built, Market Position, Business Model, Traction, Post-Mortem, Key Lessons). Section content is full narrative text. The report_sections field may be absent for companies without a complete analysis.Can I paginate through all YC companies in a single batch?+
list_companies_by_batch endpoint returns all available companies for the specified batch in a single response — there is no pagination parameter. The count field tells you how many were returned. Older batches may return fewer results due to limited data coverage on the source site.Does the API expose founding year, funding rounds, or valuation data?+
search_companies and related list endpoints return foundedYear for companies where it is available. Funding round details, valuation figures, and investor lists are not currently exposed by any endpoint. You can fork this API on Parse and revise it to add an endpoint targeting that data if the source provides it.Is there a way to filter `search_companies` results by status or batch?+
search_companies endpoint only accepts a query string and an optional limit. Server-side filtering by status or batch is not supported in that endpoint. To get all companies for a specific batch, use list_companies_by_batch with the exact batch name from list_batches. You can fork this API on Parse and revise the search endpoint to add filter parameters if that capability is needed.