# Hacker News API: List stories > Lists current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN or jobs list. Unofficial. Not affiliated with or endorsed by Hacker News. - Page: https://fous.com/methods/news.ycombinator.com/list-front-page - Method: `news.ycombinator.com/list_front_page`, version 1 - Website: news.ycombinator.com - Returns: rank, title, website link and domain, points, comments, author, posted time, discussion link, item id - 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 | |---|---|---|---|---| | `list_name` | string | no | | Hacker News list to read, for example ask_hn. One of "top", "newest", "best", "ask_hn", "show_hn", "jobs". Default "top". | | `max_results` | integer | no | | Maximum number of stories to return, for example 60. Default 30. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json {} ``` Its output: ```json { "stories": [ { "age": "4 hours ago", "rank": 1, "title": "Local Wikipedia: Wikipedia, but only for things a half hour walk from you", "author": "sohkamyung", "points": 378, "item_id": 50202285, "posted_at": "2026-10-22T23:01:18Z", "website_link": "https://edjefferson.com/localwiki/", "comment_count": 99, "website_domain": "edjefferson.com", "discussion_link": "https://news.ycombinator.com/item?id=50202285" }, { "age": "10 hours ago", "rank": 2, "title": "Docker is weird", "author": "psxuaw", "points": 484, "item_id": 50202681, "posted_at": "2026-10-22T23:45:56Z", "website_link": "https://codeandcake.dev/posts/2026-10-22-docker-is-weird", "comment_count": 219, "website_domain": "codeandcake.dev", "discussion_link": "https://news.ycombinator.com/item?id=50202681" }, { "age": "5 hours ago", "rank": 3, "title": "How does Fable 5.1 hide messages in images?", "author": "gmays", "points": 87, "item_id": 50201445, "posted_at": "2026-10-22T21:41:13Z", "website_link": "https://www.lesswrong.com/posts/WHEQps5PK8LrrcTAb/how-does-fable-5-1-hide-messages-in-images", "comment_count": 26, "website_domain": "www.lesswrong.com", "discussion_link": "https://news.ycombinator.com/item?id=50201445" } ] } ``` ## 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":"news.ycombinator.com/list_front_page","input":{}}' ``` 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 - What are the top 30 stories on Hacker News right now? - Show me the 60 newest posts on HN with their points and comment counts - Pull the best-ranked Hacker News stories this week, including author and posted time - I need the latest Ask HN questions, around 15 of them, with links to discussion threads - Can you list the current Show HN projects in rank order with their domains and item ids? ## Input schema ```json { "type": "object", "required": [], "properties": { "list_name": { "enum": [ "top", "newest", "best", "ask_hn", "show_hn", "jobs" ], "type": "string", "default": "top", "description": "Hacker News list to read, for example ask_hn." }, "max_results": { "type": "integer", "default": 30, "maximum": 100, "minimum": 1, "description": "Maximum number of stories to return, for example 60." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "discussion_link", "item_id" ], "properties": { "age": { "type": [ "string", "null" ] }, "rank": { "type": "integer" }, "title": { "type": "string" }, "author": { "type": [ "string", "null" ] }, "points": { "type": [ "integer", "null" ] }, "item_id": { "type": "integer" }, "posted_at": { "type": [ "string", "null" ] }, "website_link": { "type": [ "string", "null" ] }, "comment_count": { "type": [ "integer", "null" ] }, "website_domain": { "type": [ "string", "null" ] }, "discussion_link": { "type": "string" } } } } } } ``` ## See more - [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: 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: 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: 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: Get YC company profile](https://fous.com/methods/ycombinator.com/get-company.md): Looks up a Y Combinator company by name or YC company page link and returns its profile, founders, social links and open job count. - [The New York Times API: List headlines](https://fous.com/methods/nytimes.com/list-headlines.md): Lists current New York Times headlines with summaries, authors, images and publication times, in the order shown on the chosen section page (top stories or a section). Video-only items, ads and promotions are left out; times come from the section's feed and may be missing. - [Steam API: List top sellers](https://fous.com/methods/store.steampowered.com/list-top-sellers.md): Lists Steam's top-selling, discounted, or new and trending games in store order, with prices for a chosen country, review summaries and release dates. - [TechCrunch API: List headlines](https://fous.com/methods/techcrunch.com/list-headlines.md): Lists the latest TechCrunch story headlines in a section, in page order. Skips video, podcast and event promotion cards. - [All Hacker News methods](https://fous.com/methods/ycombinator.com.md)