Hacker News scraper API
The InsightSocial Hacker News API has 13 endpoints, from 20 credits a call. A story call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.
Hacker News as JSON: stories with their comment threads, users and their submissions, the front-page feeds, keyword search, and the monthly Who is Hiring jobs as rows.
13 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/hackernews/story?id=40000001" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Hacker News data can you get?
Public Hacker News data only, in the same JSON envelope as every other platform. Every Hacker News endpoint is beta: inside data it returns Hacker News's own structure under our naming rules (snake_case keys, string ids, ISO times where Hacker News gives a timestamp), not the shared profile and post schema, and fields may change.
Stories and comment threads
A story, its comment thread up to 100 comments a page, any item by id, and a comment with its chain of parents up to the story.
Feeds and search
The top, new, best, Ask, Show and jobs feeds, and keyword search with sorting, date range, points, author and domain filters.
Users
A user's profile, their comments and submissions newest first, and their favorites.
Who is Hiring
The top-level job posts from the monthly Who is Hiring thread, the latest one or any month.
What people build with the Hacker News API
Launch tracking
Search for your product or domain, then page through the comments of each story to read what developers said.
Hiring market data
Read every month's Who is Hiring posts as rows and count roles, stacks and remote offers over time.
Front-page datasets
Snapshot the top or best feed on a schedule and keep scores and comment counts for your own analysis.
Hacker News API endpoints
All 13 Hacker News endpoints and their price in credits. Every one has a fixed price.
| Endpoint | Credits | What it returns |
|---|---|---|
| /comment/context | 40 | Get a Hacker News comment with its ancestor chain to the root story. |
| /feed | 20 | List a Hacker News feed by type (top, new, best, ask, show, or jobs). |
| /item | 20 | Get a Hacker News item by id. |
| /jobs/who-is-hiring | 20 | List top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month). |
| /maxitem | 20 | Get the current largest Hacker News item id. |
| /search | 20 | Search Hacker News by keyword. |
| /story | 20 | Get a Hacker News story by id. |
| /story/comments | 40 | List comments on a Hacker News story by id. |
| /updates | 20 | Get recently changed Hacker News item ids and usernames. |
| /user | 20 | Get a Hacker News user profile by username. |
| /user/comments | 20 | List a Hacker News user's comments (newest first). |
| /user/favorites | 20 | List favorites for a Hacker News user by username. |
| /user/submissions | 20 | List a Hacker News user's stories, polls, and jobs (newest first). |
Parameters, response fields and examples for each endpoint are in the Hacker News API reference.
InsightSocial vs the official Hacker News API
The official Hacker News API is free, needs no key, and returns items and users by id, one request per item. It has no keyword search.
| InsightSocial API | Official Hacker News API | |
|---|---|---|
| Comment threads | Up to 100 comments a call, then a cursor | One request per comment id |
| Keyword search | Search with date, points and author filters | Not offered |
| Who is Hiring | Job posts as rows, by month | Read the thread item by item |
| Cost per call | 20 credits | Free, no key |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Hacker News API cost?
Hacker News calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 story lookups at 20 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Hacker News data in plain English. Same account, same credits.
Hacker News API: frequently asked questions
It is free and needs no key, and for single items it is the simplest choice. Here a story's comments come back up to 100 a call instead of one request per comment, keyword search is built in, and the same key and credit balance work on every other platform.
Yes. /v1/hackernews/story/comments takes a story id and returns its comments, up to 100 a page with a cursor for the rest. /v1/hackernews/comment/context returns one comment with its parents up to the root story.
/v1/hackernews/search takes a query and filters for type, sort, date range, author, domain, URL and minimum points.
/v1/hackernews/jobs/who-is-hiring returns the top-level job posts from the latest thread, or from a month you name as YYYY-MM.
They return Hacker News's own record shapes under our naming rules (snake_case keys, string ids, ISO times) rather than the shared profile and post entities, so fields may change. Most Hacker News endpoints are 20 credits a call; a story's comments and a comment's context are 40. Calls that fail or find nothing are free.
No. There is no Hacker News app, OAuth flow or review. One API key in the x-api-key header works for Hacker News and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Hacker News's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Hacker News API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API