InsightSocial

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"
200 OKJSON
{
"success": true,
"platform": "hackernews",
"endpoint": "/v1/hackernews/story",
"schema_version": "2",
"data": {
"story": {
"id": "40000001",
"author": "example_user",
"created_at": "2026-11-10T14:02:11.000Z",
"title": "Show HN: An example open-source database",
"text": null,
"url": "https://example.com/blog/launch",
"score": 412,
"comment_count": 168,
"dead": false,
"deleted": false,
"item_url": "https://news.ycombinator.com/item?id=40000001"
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

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.

EndpointCreditsWhat it returns
/comment/context40Get a Hacker News comment with its ancestor chain to the root story.
/feed20List a Hacker News feed by type (top, new, best, ask, show, or jobs).
/item20Get a Hacker News item by id.
/jobs/who-is-hiring20List top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month).
/maxitem20Get the current largest Hacker News item id.
/search20Search Hacker News by keyword.
/story20Get a Hacker News story by id.
/story/comments40List comments on a Hacker News story by id.
/updates20Get recently changed Hacker News item ids and usernames.
/user20Get a Hacker News user profile by username.
/user/comments20List a Hacker News user's comments (newest first).
/user/favorites20List favorites for a Hacker News user by username.
/user/submissions20List 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 APIOfficial Hacker News API
Comment threadsUp to 100 comments a call, then a cursorOne request per comment id
Keyword searchSearch with date, points and author filtersNot offered
Who is HiringJob posts as rows, by monthRead the thread item by item
Cost per call20 creditsFree, 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.

Use it from Claude or ChatGPT

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.