yc-api 1.0.0

Typed Python client for the unofficial Y Combinator companies API

yc-api

Typed Python client for the unofficial Y Combinator companies API.

Install

pip install yc-api

Quick start

from yc_api import YCClient

client = YCClient()

# All companies
companies = client.get_all()

# Currently hiring
hiring = client.get_hiring()

# Single company
company = client.get_company("winter-2026", "airbnb")
print(company.name, company.one_liner)

# Founders with emails
for founder in company.founders:
    if founder.email:
        print(f"  {founder.full_name}: {founder.email}")

# Filter
ai_companies = client.search(tag="AI", hiring=True)

Async

Every method has an async counterpart prefixed with a:

import asyncio
from yc_api import YCClient

async def main():
    client = YCClient()
    companies = await client.aget_all()
    print(len(companies))

asyncio.run(main())

Models

All responses are fully typed with Pydantic models:

• Company — full company object with founders, jobs, news, launches
• Founder — name, bio, social links, SMTP-verified email
• Job — title, location, salary/equity range, visa status, skills
• News — press articles
• Launch — Launch YC posts
• Partner — assigned YC group partner
• Meta — API index with counts and endpoint URLs

License

MIT