Hacker News API: Get YC company profile
Looks up a Y Combinator company by name or YC company page link and returns its profile, founders, social links and open job count.
Unofficial. Not affiliated with or endorsed by Hacker News.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Company, required
company The YC company name or its YC company page link, for example Airbnb or https://www.ycombinator.com/companies/airbnb.
Airbnb
Input as JSON
{ "company": "Airbnb"}Output
{ "name": "Airbnb", "batch": "Winter 2009", "status": "Public", "website": "http://airbnb.com" , "founders": [ { "name": "Brian Chesky", "title": "Founder/CEO" , "linkedin_link": "https://www.linkedin.com/in/brianchesky/" }, { "name": "Nathan Blecharczyk", "title": "Founder/CTO" , "linkedin_link": "https://www.linkedin.com/in/blecharczyk/" }, { "name": "Joe Gebbia", "title": "Founder/CPO" , "linkedin_link": "https://www.linkedin.com/in/jgebbia/" } ], "location": "San Francisco", "jobs_link": "https://www.ycombinator.com/companies/airbnb/jobs" , "team_size": 6132, "industries": [ "Marketplace", "Travel" ], "founded_year": 2008, "social_links": { "github": null, "twitter": "https://twitter.com/Airbnb" , "facebook": "https://www.facebook.com/airbnb/" , "linkedin": "https://www.linkedin.com/company/airbnb/" , "crunchbase": "https://www.crunchbase.com/organization/airbnb" }, "yc_page_link": "https://www.ycombinator.com/companies/airbnb" , "open_jobs_count": 0, "long_description": "Founded in August of 2008 and based in San Francisco, California, Airbnb is a trusted community marketplace for people to list, discover, and book unique accommodations around the world — online or from a mobile phone. Whether an apartment for a night, a castle for a week, or a villa for a month, Ai…", "one_line_description": "Book accommodations around the world."}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ycombinator.com/get_company","input":{"company":"Airbnb"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ycombinator.com/get_company" , "input": { "company": "Airbnb" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ycombinator.com/get_company" , "input": { "company": "Airbnb" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ycombinator.com/get_company# with {"company":"Airbnb"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "The YC company name or its YC company page link, for example Airbnb or https://www.ycombinator.com/companies/airbnb." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "name", "one_line_description", "long_description", "batch", "status", "industries", "founded_year", "team_size", "location", "website", "founders", "social_links", "open_jobs_count", "jobs_link", "yc_page_link" ], "properties": { "name": { "type": "string" }, "batch": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "founders": { "type": "array", "items": { "type": "object", "required": [ "name", "title", "linkedin_link" ], "properties": { "name": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "linkedin_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "location": { "type": [ "string", "null" ] }, "jobs_link": { "type": "string" }, "team_size": { "type": [ "integer", "null" ] }, "industries": { "type": "array", "items": { "type": "string" } }, "founded_year": { "type": [ "integer", "null" ] }, "social_links": { "type": "object", "required": [ "linkedin", "twitter", "facebook", "github", "crunchbase" ], "properties": { "github": { "type": [ "string", "null" ] }, "twitter": { "type": [ "string", "null" ] }, "facebook": { "type": [ "string", "null" ] }, "linkedin": { "type": [ "string", "null" ] }, "crunchbase": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "yc_page_link": { "type": "string" }, "open_jobs_count": { "type": "integer" }, "long_description": { "type": [ "string", "null" ] }, "one_line_description": { "type": [ "string", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ycombinator.com/get_company- Returns
- name, description, batch, status, industries, founders, social links, open jobs count, YC page link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ycombinator.com/get_company with the inputs above.
Ask your agent
- Can you pull up the Y Combinator profile for Stripe, including founders and how many jobs they have open?
- What batch did Dropbox go through at YC, and what industries are they tagged under?
- Show me the YC company page for https://www.ycombinator.com/companies/gitlab with its social links and status.
- I'm researching startups from the W21 batch. Look up Instacart and tell me who founded it and where to find them online.
- Find the Y Combinator listing for Coinbase and give me a description plus the number of open roles.
See more
All Hacker News methodsSearches the Y Combinator company directory by keyword, industry, batch, location, hiring and status, returning companies in directory order.
ycombinator.com/search_companiesSearches Hacker News stories or comments by words, date range and sort order. Comments include their parent story's website link when one exists; text-only stories have no website link.
news.ycombinator.com/search_storiesGets a Hacker News story and its comments in the order shown on the site. The story can be given as a discussion link or as words from its title. Deleted and flagged comments are left out.
news.ycombinator.com/get_discussionLists top-level job posts from a monthly Ask HN: Who is hiring? thread in thread order, with post text and the company, roles, location, work arrangement, salary and application contact inferred from each post.
news.ycombinator.com/list_hiring_postsLists current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN or jobs list.
news.ycombinator.com/list_front_pageGets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null.
linkedin.com/get_company_profileLooks up a UK company on Companies House by name, company number or Companies House link and returns its public registration details; a name prefers an active exact match.
company-information.service.gov.uk/get_company_profileLooks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one.
finance.yahoo.com/get_company_news