Hacker News
Hacker News API reference: 13 endpoints for stories, comments, users, feeds and search. Per-endpoint credit prices and cURL examples.
Hacker News stories and comment threads, items, users, the front-page feeds, keyword search and Who is Hiring jobs.
New to the API? Read the Hacker News scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/hackernews/...
Quickstart
curl "https://api.insightsocial.app/v1/hackernews/user?username=pg" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
Every endpoint here has a fixed price.
Every endpoint here is beta: it returns the platform's own structure under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp), not a schema-2 entity, and its fields may change. See Beta endpoints.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/comment/context | 40 | Get a Hacker News comment with its ancestor chain to the root story. Beta. | id |
/feed | 20 | List a Hacker News feed by type (top, new, best, ask, show, or jobs). Beta. | feed |
/item | 20 | Get a Hacker News item by id. Beta. | 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). Beta. | — |
/maxitem | 20 | Get the current largest Hacker News item id. Beta. | — |
/search | 20 | Search Hacker News by keyword. Beta. | — |
/story | 20 | Get a Hacker News story by id. Beta. | id |
/story/comments | 40 | List comments on a Hacker News story by id. Beta. | id |
/updates | 20 | Get recently changed Hacker News item ids and usernames. Beta. | — |
/user | 20 | Get a Hacker News user profile by username. Beta. | username |
/user/comments | 20 | List a Hacker News user's comments (newest first). Beta. | username |
/user/favorites | 20 | List favorites for a Hacker News user by username. Beta. | username |
/user/submissions | 20 | List a Hacker News user's stories, polls, and jobs (newest first). Beta. | username |