# Hacker News API

> 6 public methods for Hacker News (ycombinator.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by Hacker News.

- Page: https://fous.com/methods/ycombinator.com

## Methods

### [Search YC companies](https://fous.com/methods/ycombinator.com/search-companies.md)

`ycombinator.com/search_companies`, read. Searches the Y Combinator company directory by keyword, industry, batch, location, hiring and status, returning companies in directory order.

Returns: name, description, batch, industries, location, team size, status, website, YC page link

### [Get YC company profile](https://fous.com/methods/ycombinator.com/get-company.md)

`ycombinator.com/get_company`, read. Looks up a Y Combinator company by name or YC company page link and returns its profile, founders, social links and open job count.

Returns: name, description, batch, status, industries, founders, social links, open jobs count, YC page link

### [Search stories](https://fous.com/methods/news.ycombinator.com/search-stories.md)

`news.ycombinator.com/search_stories`, read. 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.

Returns: title, comment text, author, points, comment count, posted date, website link, Hacker News link, item ID

### [List stories](https://fous.com/methods/news.ycombinator.com/list-front-page.md)

`news.ycombinator.com/list_front_page`, read. Lists current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN or jobs list.

Returns: rank, title, website link and domain, points, comments, author, posted time, discussion link, item id

### [Get discussion](https://fous.com/methods/news.ycombinator.com/get-discussion.md)

`news.ycombinator.com/get_discussion`, read. 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.

Returns: title, link, author, points, comment count, story text, comments with depth, replies and parent

### [List Who is hiring posts](https://fous.com/methods/news.ycombinator.com/list-hiring-posts.md)

`news.ycombinator.com/list_hiring_posts`, read. 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.

Returns: thread title and link; per post: company, roles, location, work arrangement, salary, post text, application contact, posted date, comment link