{"openapi":"3.1.0","info":{"title":"ExploreYC Public API","description":"Read-only programmatic access to the ExploreYC dataset: Y Combinator and a16z portfolio companies with funding, stage, and exit data.\n\n**Auth:** send your key as `Authorization: Bearer eyc_live_…` (or `X-API-Key`). Create a key at https://exploreyc.com/dashboard.\n\n**Rate limits:** per key, rolling 24h. Free = 5 requests/day. Responses include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.","version":"1.0.0"},"paths":{"/companies":{"get":{"tags":["Companies"],"summary":"List / filter companies","operationId":"list_companies_companies_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"'yc', 'a16z', or 'all' (default)","default":"all","title":"Source"},"description":"'yc', 'a16z', or 'all' (default)"},{"name":"batch","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch"}},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"is_hiring","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hiring"}},{"name":"top_company","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Top Company"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/{company_id}":{"get":{"tags":["Companies"],"summary":"Company by id","operationId":"get_company_companies__company_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"integer","title":"Company Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompany"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/companies/slug/{slug}":{"get":{"tags":["Companies"],"summary":"Company by slug","operationId":"get_company_by_slug_companies_slug__slug__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompany"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search":{"get":{"tags":["Companies"],"summary":"Full-text company search","operationId":"search_companies_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"all","title":"Source"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stats":{"get":{"tags":["Analytics"],"summary":"Portfolio stats (Y Combinator)","operationId":"stats_stats_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sources":{"get":{"tags":["Metadata"],"summary":"Available sources (incubators / VCs)","operationId":"sources_sources_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/batches":{"get":{"tags":["Metadata"],"summary":"Distinct YC batches","operationId":"batches_batches_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/industries":{"get":{"tags":["Metadata"],"summary":"Distinct industries","operationId":"industries_industries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/countries":{"get":{"tags":["Metadata"],"summary":"Distinct countries","operationId":"countries_countries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/map":{"get":{"tags":["Analytics"],"summary":"Geo-located companies","operationId":"geo_map_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"batch","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch"}},{"name":"is_hiring","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hiring"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/batch/{batch_name}/wrapped":{"get":{"tags":["Analytics"],"summary":"Batch 'wrapped' analytics","operationId":"batch_wrapped_batch__batch_name__wrapped_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"batch_name","in":"path","required":true,"schema":{"type":"string","title":"Batch Name"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/founders":{"get":{"tags":["Founders"],"summary":"Founder leaderboards (ranked)","description":"Ranked Y Combinator founders. `funded` = total raised across their companies,\n`serial` = most YC companies, `exits` = biggest exit, `unicorns` = $1B+ valuations.\nEach row includes the founder, their derived stats, and their rank.","operationId":"list_founders_founders_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"metric","in":"query","required":false,"schema":{"type":"string","description":"Ranking metric: serial | funded | exits | unicorns","default":"funded","title":"Metric"},"description":"Ranking metric: serial | funded | exits | unicorns"},{"name":"batch","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a YC batch, e.g. 'Winter 2012'","title":"Batch"},"description":"Filter to a YC batch, e.g. 'Winter 2012'"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/founders/{slug}":{"get":{"tags":["Founders"],"summary":"Founder profile + stats + companies","description":"A single founder: identity, derived stats, the YC companies they founded, every\nleaderboard rank they hold, and (web-sourced) enrichment if available.","operationId":"get_founder_founders__slug__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CompanyListResponse":{"properties":{"companies":{"items":{"$ref":"#/components/schemas/PublicCompany"},"type":"array","title":"Companies"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["companies","total","limit","offset","has_more"],"title":"CompanyListResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PublicCompany":{"properties":{"id":{"type":"integer","title":"Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"one_liner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"One Liner"},"long_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Description"},"team_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Team Size"},"batch":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"subindustry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subindustry"},"all_locations":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"All Locations"},"is_hiring":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Hiring"},"top_company":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Top Company"},"nonprofit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nonprofit"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"small_logo_thumb_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Small Logo Thumb Url"},"founders":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Founders"},"year_founded":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year Founded"},"exit_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exit Type"},"acquirer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Acquirer"},"ticker_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker Symbol"},"funded_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Funded Date"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"funding_total_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Funding Total Usd"},"funding_last_round_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Funding Last Round Usd"},"funding_last_round_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Funding Last Round Name"},"funding_last_round_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Funding Last Round Date"},"valuation_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Valuation Usd"},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count"},"employee_growth_6m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Employee Growth 6M"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id"],"title":"PublicCompany"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","description":"Your ExploreYC API key (eyc_live_…)","scheme":"bearer"}}},"servers":[{"url":"/api/v1"}]}