Private Beta—Found a bug or have feedback? Share it →

HackerNews

Hacker News top stories and item detail. Two-step workflow: call /topstories to get a list of story IDs, then call /story?id=<id> to fetch full content for each story. Free, no key required.

Healthy

News & SentimentNo upstream key required

Base URL

https://api.apiclearinghouse.com/v1/call/hackernews

Authenticate with X-Api-Key: chk_live_... header.

GET/topstories

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/hackernews/topstories" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "story_ids": "abc123"
  }
}

GET/story

Parameters

Name	Type	Required	Description
id	string	required	HackerNews item ID (integer as string). Get IDs from /topstories first.

Example Request

curl -s "https://api.apiclearinghouse.com/v1/call/hackernews/story?id={id}" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response

{
  "status": "success",
  "data": {
    "by": "example",
    "id": "abc123",
    "url": "example",
    "time": "example",
    "type": "example"
  }
}

Try it live

No setup required. Sign in and run HackerNews directly from your browser.

Open in Explorer →

Rate Limits

Free10/min

Pro100/min

Elite500/min

Monthly limits also apply per plan.

Authentication

Pass your API key in the request header:

X-Api-Key: chk_live_...

Join the beta

← Back to catalog