Skip to main content
POST
/yc/search/companies

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
timeout
integer
default:300
Required range: 20 <= x <= 1500
query
string
default:""
industries
string[] | null
regions
string[] | null
batches
string[] | null
is_hiring
boolean | null
nonprofit
boolean | null
top_company
boolean | null
team_size_min
integer | null
Required range: x >= 1
team_size_max
integer | null
Required range: x <= 10000
sort_by
enum<string>
default:relevance
Available options:
relevance,
launch_date

Response

Successful Response

id
integer
required
name
string
required
slug
string
required
@type
string
default:YCCompany
website
string | null
one_liner
string | null
long_description
string | null
team_size
integer | null
industry
string | null
subindustry
string | null
industries
string[]
regions
string[]
batch
string | null
status
string | null
stage
string | null
tags
string[]
is_hiring
boolean | null
nonprofit
boolean | null
top_company
boolean | null
launched_at
integer | null
all_locations
string | null
small_logo_thumb_url
string | null
former_names
string[]
app_video_public
boolean | null
demo_day_video_public
boolean | null
app_answers
boolean | null
question_answers
boolean | null
founders
object[]
jobs
object[]
year_founded
integer | null
city
string | null
country
string | null
logo_url
string | null
news_items
object[]
launches
object[]
company_photos
object[]
primary_partner
object | null