Skip to main content
POST
/
api
/
yc
/
search
/
companies
/yc/search/companies
curl --request POST \
  --url https://api.anysite.io/api/yc/search/companies \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 123,
  "timeout": 300,
  "query": "",
  "industries": [
    "<string>"
  ],
  "regions": [
    "<string>"
  ],
  "batches": [
    "<string>"
  ],
  "is_hiring": true,
  "nonprofit": true,
  "top_company": true,
  "team_size_min": 2,
  "team_size_max": 123,
  "sort_by": "relevance"
}
'
[
  {
    "id": 123,
    "name": "<string>",
    "slug": "<string>",
    "@type": "@yc_company",
    "website": "<string>",
    "one_liner": "<string>",
    "long_description": "<string>",
    "team_size": 123,
    "industry": "<string>",
    "subindustry": "<string>",
    "industries": [],
    "regions": [],
    "batch": "<string>",
    "status": "<string>",
    "stage": "<string>",
    "tags": [],
    "is_hiring": true,
    "nonprofit": true,
    "top_company": true,
    "launched_at": 123,
    "all_locations": "<string>",
    "small_logo_thumb_url": "<string>",
    "former_names": [],
    "app_video_public": true,
    "demo_day_video_public": true,
    "app_answers": true,
    "question_answers": true,
    "founders": [],
    "jobs": [],
    "social_links": {
      "@type": "@yc_social_links",
      "linkedin": "<string>",
      "twitter": "<string>",
      "facebook": "<string>",
      "crunchbase": "<string>",
      "github": "<string>"
    },
    "year_founded": 123,
    "city": "<string>",
    "country": "<string>",
    "logo_url": "<string>",
    "news_items": [],
    "launches": [],
    "company_photos": [],
    "primary_partner": {
      "name": "<string>",
      "@type": "@yc_partner",
      "url": "<string>"
    }
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max result count

​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
query
string
default:""

Text search query

​
industries
string[] | null

Filter by industries (e.g., 'Healthcare', 'B2B')

​
regions
string[] | null

Filter by regions (e.g., 'Latin America', 'Europe')

​
batches
string[] | null

Filter by YC batches (e.g., 'W24', 'S24', 'W25', 'S25')

​
is_hiring
boolean | null

Filter by hiring status

​
nonprofit
boolean | null

Filter by nonprofit status

​
top_company
boolean | null

Filter by top company status

​
team_size_min
integer | null

Minimum team size

Required range: x >= 1
​
team_size_max
integer | null

Maximum team size

Required range: x <= 10000
​
sort_by
enum<string>
default:relevance

Sort results by relevance or launch date

Available options:
relevance,
launch_date

Response

Successful Response

​
id
integer
required
​
name
string
required
​
slug
string
required
​
@type
string
default:@yc_company
​
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
YCFounder · object[]
​
jobs
YCJob · object[]
​
social_links
YCSocialLinks · object
​
year_founded
integer | null
​
city
string | null
​
country
string | null
​
logo_url
string | null
​
news_items
YCNewsItem · object[]
​
launches
YCLaunch · object[]
​
company_photos
YCPhoto · object[]
​
primary_partner
YCPartner · object