The playground

Try any of 1042 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com

post/hackernews/v1/stories2 credits

story-list (list=top/new/best/ask/show/job) → ranked hydrated stories; offset/limit pagination, hydrate=false for ids only

Working example

Parameters

listoptional

Which HackerNews story list to return.

limitoptional

Stories to return (1-100, default 30). Out-of-range values are clamped. (1–100)

offsetoptional

Pagination offset into the story list (0-500). Skip N ranked stories. (0–500)

hydrateoptional

If true, resolve each ranked story id into full objects instead of bare ids (default true).

request preview

curl -X POST https://api.reefapi.com/hackernews/v1/stories \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"list":"top","limit":"15"}'

Hit Send to run this endpoint live.