# 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.

- Page: https://fous.com/methods/ycombinator.com/get-company
- Method: `ycombinator.com/get_company`, version 1
- Website: ycombinator.com
- Returns: name, description, batch, status, industries, founders, social links, open jobs count, YC page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Airbnb"` | The YC company name or its YC company page link, for example Airbnb or https://www.ycombinator.com/companies/airbnb. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "company": "Airbnb"
}
```

Its output:

```json
{
  "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."
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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.

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [Hacker News API: Search YC companies](https://fous.com/methods/ycombinator.com/search-companies.md): Searches the Y Combinator company directory by keyword, industry, batch, location, hiring and status, returning companies in directory order.
- [Hacker News API: Search stories](https://fous.com/methods/news.ycombinator.com/search-stories.md): Searches 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.
- [Hacker News API: Get discussion](https://fous.com/methods/news.ycombinator.com/get-discussion.md): Gets 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.
- [Hacker News API: List Who is hiring posts](https://fous.com/methods/news.ycombinator.com/list-hiring-posts.md): Lists 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.
- [Hacker News API: List stories](https://fous.com/methods/news.ycombinator.com/list-front-page.md): Lists current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN or jobs list.
- [LinkedIn API: Get company profile](https://fous.com/methods/linkedin.com/get-company-profile.md): Gets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null.
- [Companies House API: Get UK company profile](https://fous.com/methods/company-information.service.gov.uk/get-company-profile.md): Looks 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.
- [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks 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.
- [All Hacker News methods](https://fous.com/methods/ycombinator.com.md)
