Hacker News
News stories, discussion comments and hiring posts
Hacker News provides current ranked story lists, searchable stories and comments, discussion threads with up to 500 visible comments excluding deleted or flagged ones, and monthly hiring posts with details when stated.
Your information
Hacker News discussion link or words from the story title, for example https://news.ycombinator.com/item?id=8863 or Ask HN: What are you working on?
Maximum comments to return, for example 100 (at most 500).
Example results
My YC app: Dropbox - Throw away your USB drive
Points104
Comments71
PostedApr 4, 7:16 PM
By dhouston
Comments
About the Hacker News tool
Hacker News (HN) lists ranked stories; choose a list and maximum results.
Search stories finds stories or comments using a required query and optional filters.
Get discussion reads a story and its comments from a link or title words; List hiring posts finds monthly job posts with optional filters.
Built from news.ycombinator.com and hn.algolia.com. Last checked Oct 7, 2026.
Actions
Get discussion
1 creditGet a Hacker News story and its comment thread in displayed order from a discussion link or title words. Returns up to 500 visible comments; deleted and flagged comments are excluded.
Uses Hacker News and hn.algolia.com.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Storystory | Text | Required | Hacker News discussion link or words from the story title, for example https://news.ycombinator.com/item?id=8863 or Ask HN: What are you working on?Example: https://news.ycombinator.com/item?id=8863 |
Max Commentsmax_comments | Number | Optional | Maximum comments to return, for example 100 (at most 500).Example: 10 |
What you get
| Field | Type | Description |
|---|---|---|
Titletitle | Text | Example: My YC app: Dropbox - Throw away your USB drive |
Authorauthor | Text | Example: Dhouston |
Pointspoints | Number | Example: 104 |
Item IDitem_id | Number | Example: 8863 |
Commentscomments | List | |
Linkcomments[].link | Text | Example: https://news.ycombinator.com/item?id=9224 |
Textcomments[].text | Text | Example: Huge problem, interesting solution. It takes time to derive the high-level… |
Depthcomments[].depth | Number | Example: 0 |
Authorcomments[].author | Text | Example: BrandonM |
Item IDcomments[].item_id | Number | Example: 9224 |
Parent IDcomments[].parent_id | Number | Example: 8863 |
Posted Atcomments[].posted_at | Date | Example: 2007-04-05T15:16:54Z |
Direct Repliescomments[].direct_replies | Number | Example: 1 |
Posted Atposted_at | Date | Example: 2007-04-04T19:16:40Z |
Story Textstory_text | Text | Example: With the quarantine being placed in effect in a lot of cities across the… |
Website Linkwebsite_link | Text | Example: http://www.getdropbox.com/u/2/screencast.html |
Comment Countcomment_count | Number | Example: 71 |
Discussion Linkdiscussion_link | Text | Example: https://news.ycombinator.com/item?id=8863 |
Example result
For Story: https://news.ycombinator.com/item?id=8863, Max Comments: 10
JSON
{
"title": "My YC app: Dropbox - Throw away your USB drive",
"author": "dhouston",
"points": 104,
"item_id": 8863,
"comments": [
{
"link": "https://news.ycombinator.com/item?id=9224",
"text": "I have a few qualms with this app:\n1. For a Linux user, you can already build such a system yourself quite trivially by getting an FTP account, mounting it locally with curlftpfs, and then using SVN o…",
"depth": 0,
"author": "BrandonM",
"item_id": 9224,
"parent_id": 8863,
"posted_at": "2007-04-05T15:16:54Z",
"direct_replies": 1
},
{
"link": "https://news.ycombinator.com/item?id=9272",
"text": "1. re: the first part, many people want something plug and play. and even if they were plug and play, the problem is that the user experience (on windows at least) with online drives generally sucks, …",
"depth": 1,
"author": "dhouston",
"item_id": 9272,
"parent_id": 9224,
"posted_at": "2007-04-05T16:47:01Z",
"direct_replies": 1
},
{
"link": "https://news.ycombinator.com/item?id=9479",
"text": "You are correct that this presents a very good, easy-to-install piece of functionality for Windows users. The Windows shortcomings that you point out are certainly problems, and I think that your soft…",
"depth": 2,
"author": "BrandonM",
"item_id": 9479,
"parent_id": 9272,
"posted_at": "2007-04-06T01:39:04Z",
"direct_replies": 0
}
],
"posted_at": "2007-04-04T19:16:40Z",
"story_text": null,
"website_link": "http://www.getdropbox.com/u/2/screencast.html",
"comment_count": 71,
"discussion_link": "https://news.ycombinator.com/item?id=8863"
}List front page
1 creditList current Hacker News stories in rank order from the top, newest, best, Ask HN, Show HN, or jobs list. Jobs may not show points, comments, or an author.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
List Namelist_name | Text | Optional | Hacker News list to read, for example ask_hn.Example: Ask hn |
Max Resultsmax_results | Number | Optional | Maximum number of stories to return, for example 60.Example: 10 |
What you get
| Field | Type | Description |
|---|---|---|
Storiesstories | List | |
Agestories[].age | Text | Relative age as displayed by Hacker News.Example: 4 hours ago |
Rankstories[].rank | Number | Position on the list.Example: 1 |
Titlestories[].title | Text | Story title.Example: Jeff – Jev-compatible 0.8B decision models, trained at home, ~30 ms |
Authorstories[].author | Text | Posting user, if shown.Example: Firelex |
Pointsstories[].points | Number | Points shown on Hacker News, if available.Example: 230 |
Item IDstories[].item_id | Number | Hacker News item ID.Example: 49883844 |
Posted Atstories[].posted_at | Text | Posting time in ISO 8601 UTC, if shown.Example: 2026-09-28T20:23:36Z |
Website Linkstories[].website_link | Text | Link to the story website; null for Ask HN or other posts without an external website.Example: https://github.com/firelex/jeff |
Comment Countstories[].comment_count | Number | Number of comments shown, if available.Example: 79 |
Website Domainstories[].website_domain | Text | Domain of the story website.Example: github.com |
Discussion Linkstories[].discussion_link | Text | Link to the Hacker News discussion page.Example: https://news.ycombinator.com/item?id=49883844 |
Example result
For
JSON
{
"stories": [
{
"age": "4 hours ago",
"rank": 1,
"title": "Jeff – Jev-compatible 0.8B decision models, trained at home, ~30 ms",
"author": "firelex",
"points": 230,
"item_id": 49883844,
"posted_at": "2026-09-28T20:23:36Z",
"website_link": "https://github.com/firelex/jeff",
"comment_count": 79,
"website_domain": "github.com",
"discussion_link": "https://news.ycombinator.com/item?id=49883844"
},
{
"age": "8 hours ago",
"rank": 2,
"title": "Pirating the Pirates",
"author": "piotrgrabowski",
"points": 396,
"item_id": 49880036,
"posted_at": "2026-09-28T15:54:15Z",
"website_link": "https://mubi.com/en/notebook/posts/pirating-the-pirates",
"comment_count": 206,
"website_domain": "mubi.com",
"discussion_link": "https://news.ycombinator.com/item?id=49880036"
},
{
"age": "5 hours ago",
"rank": 3,
"title": "12,000-year-old Göbeklitepe burials explain scattered bones",
"author": "yusufaytas",
"points": 66,
"item_id": 49855059,
"posted_at": "2026-09-26T10:16:26Z",
"website_link": "https://archaeologymag.com/2026/09/gobeklitepe-burials-hundreds-of-scattered-bones/",
"comment_count": 14,
"website_domain": "archaeologymag.com",
"discussion_link": "https://news.ycombinator.com/item?id=49855059"
}
]
}List hiring posts
1 creditList top-level job posts from a monthly “Ask HN: Who is hiring?” thread in thread order, with post text, job details and application contact when available. Job details are inferred from posts and may be missing when a post does not state them.
Uses hn.algolia.com.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Monthmonth | Text | Optional | Thread month, such as 2026-09 or September 2026. Leave blank for the latest available thread.Example: 2026-08 |
Keywordskeywords | Text | Optional | Words that must all appear in the full post, ignoring case; for example, remote Python.Example: remote Python |
Max Resultsmax_results | Number | Optional | Maximum number of matching posts to return, from 1 to 500; for example, 50.Example: 5 |
Remote Onlyremote_only | Yes or no | Optional | Only include posts offering remote work; for example, true.Example: Yes |
What you get
| Field | Type | Description |
|---|---|---|
Job Postsjob_posts | List | Matching top-level posts, in thread order. |
Rolesjob_posts[].roles | Text | Job roles named in the post, if clear.Example: Senior Software Engineer (Dev Platform) |
Salaryjob_posts[].salary | Text | Salary as written, if stated.Example: 60-100k EUR; 50-90k; 50-90k |
Companyjob_posts[].company | Text | Company named in the post, if clear.Example: Proxima Fusion |
Locationjob_posts[].location | Text | Location or geographic eligibility stated in the post, if clear.Example: Munich, Germany; ONSITE |
Post Textjob_posts[].post_text | Text | Full post in plain text. |
Posted Datejob_posts[].posted_date | Date | Date the comment was posted.Example: 2026-08-04 |
Comment Linkjob_posts[].comment_link | Text | Link to the comment.Example: https://news.ycombinator.com/item?id=49165394 |
Work Arrangementjob_posts[].work_arrangement | Text | Remote, onsite, hybrid, or null when unclear.Example: Onsite |
Application Contactjob_posts[].application_contact | Text | Application link or email address, if given.Example: https://jobs.ashbyhq.com/proxima-fusion/5aebfef0-0c2c-4c87-990d-bbbbd53b94d2 |
Thread Linkthread_link | Text | Link to the monthly hiring thread.Example: https://news.ycombinator.com/item?id=49156683 |
Thread Titlethread_title | Text | Title of the monthly hiring thread.Example: Ask HN: Who is hiring? (August 2026) |
Example result
For Month: 2026-08, Max Results: 5
JSON
{
"job_posts": [
{
"roles": "Senior Software Engineer (Dev Platform)",
"salary": null,
"company": "Proxima Fusion",
"location": "Munich, Germany; ONSITE",
"post_text": "Proxima Fusion | Senior Software Engineer (Dev Platform) | Munich, Germany | ONSITE | Full-time\nWe're building the world's first commercial stellarator fusion power plant. First spin-out from the Max …",
"posted_date": "2026-08-04",
"comment_link": "https://news.ycombinator.com/item?id=49165394",
"work_arrangement": "onsite",
"application_contact": "https://jobs.ashbyhq.com/proxima-fusion/5aebfef0-0c2c-4c87-990d-bbbbd53b94d2"
},
{
"roles": "macOS low-level Open Source Developers",
"salary": null,
"company": "CodeWeavers",
"location": "St Paul, MN, USA; REMOTE",
"post_text": "CodeWeavers | St Paul, MN, USA | Full Time | REMOTE | macOS low-level Open Source Developers | C-language systems programming\nhttps://www.codeweavers.com/about/jobs\nCodeWeavers needs new, full-time de…",
"posted_date": "2026-08-03",
"comment_link": "https://news.ycombinator.com/item?id=49159312",
"work_arrangement": "remote",
"application_contact": "https://www.codeweavers.com/about/jobs"
}
],
"thread_link": "https://news.ycombinator.com/item?id=49156683",
"thread_title": "Ask HN: Who is hiring? (August 2026)"
}Search stories
1 creditSearch 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.
Uses hn.algolia.com.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Pagepage | Number | Optional | Page number, starting with 1, such as 2.Example: 2 |
Sortsort | Text | Optional | Order by relevance or newest, such as newest.Example: Newest |
Typetype | Text | Optional | Search stories or comments, such as comments.Example: Comments |
Queryquery | Text | Required | Words to search for, such as remote work.Example: remote work |
Max Resultsmax_results | Number | Optional | Maximum results on this page, such as 20.Example: 3 |
Time Windowtime_window | Text | Optional | How far back to search, such as past_week.Example: Past month |
What you get
| Field | Type | Description |
|---|---|---|
Resultsresults | List | Stories or comments matching the search. |
Titleresults[].title | Text | Story title.Example: Remote work doesn't seem to affect productivity, Fed study finds |
Authorresults[].author | Text | Hacker News author.Example: simula67 |
Pointsresults[].points | Number | Story points, when available.Example: 848 |
Item IDresults[].item_id | Text | Hacker News item ID.Example: 39037589 |
Posted Atresults[].posted_at | Text | Posted date and time in UTC, ISO 8601.Example: 2024-01-18T03:55:56Z |
Website URLresults[].website_url | Text | Story website link, or null for a text-only story.Example: https://www.bloomberg.com/news/articles/2024-01-16/remote-work-doesn-t-seem-to… |
Comment Textresults[].comment_text | Text | Comment in plain text; null for stories.Example: Trading algorithms at big shops read headline "CEO of company leaves for… |
Comment Countresults[].comment_count | Number | Number of story comments; null for comments.Example: 579 |
Hacker News URLresults[].hacker_news_url | Text | Link to the item on Hacker News.Example: https://news.ycombinator.com/item?id=39037589 |
Example result
For Query: remote work
JSON
{
"results": [
{
"title": "Remote work doesn't seem to affect productivity, Fed study finds",
"author": "simula67",
"points": 848,
"item_id": "39037589",
"posted_at": "2024-01-18T03:55:56Z",
"website_url": "https://www.bloomberg.com/news/articles/2024-01-16/remote-work-doesn-t-seem-to-affect-productivity-fed-study-finds",
"comment_text": null,
"comment_count": 579,
"hacker_news_url": "https://news.ycombinator.com/item?id=39037589"
},
{
"title": "Written communication is remote work super power",
"author": "snird",
"points": 831,
"item_id": "23577228",
"posted_at": "2020-06-19T18:08:45Z",
"website_url": "https://snir.dev/blog/remote-async-communication/",
"comment_text": null,
"comment_count": 190,
"hacker_news_url": "https://news.ycombinator.com/item?id=23577228"
},
{
"title": "SSH hacks – a little sanity for remote workers",
"author": "mxfurman",
"points": 770,
"item_id": "23025756",
"posted_at": "2020-04-29T23:20:48Z",
"website_url": "https://smallstep.com/blog/ssh-tricks-and-tips/",
"comment_text": null,
"comment_count": 227,
"hacker_news_url": "https://news.ycombinator.com/item?id=23025756"
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
cURL
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@hacker-news",
"visibility": "public",
"operation": "get_discussion",
"version": 1,
"input": {
"story": "https://news.ycombinator.com/item?id=8863",
"max_comments": 10
},
"response": {
"format": "json"
}
}'What you can do with it
- Track stories across Hacker News lists
- Find stories and comments about a topic
- Review a story’s comment thread
- Compare roles, salaries, and locations in hiring posts
- Find remote jobs in monthly hiring threads
Questions about Hacker News
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Hacker News tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Hacker News account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from news.ycombinator.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Oct 7, 2026.
What is trending on Hacker News?
Use List front page to read current stories in rank order from a selected list.
What are people saying about a topic?
Use Search stories to find stories or comments by query, date range, and sort order.
What jobs are listed in a hiring thread?
Use List hiring posts to return top-level posts and available job details from a monthly thread.