Try any of 1044 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.
Full-text search: query + tags(story/comment/ask_hn/show_hn/poll/front_page/author_X/story_X) + min_points/max_points/min_comments/before/after + sort(relevance|date), paginated
Full-text search keywords. search needs query OR tags.
Tag filter. Built-ins: story, comment, ask_hn, show_hn, poll, front_page. Dynamic: author_USERNAME, story_ID. Comma-joins = AND, (a,b) = OR. search needs query OR tags.
Result ordering: relevance (default) or date (newest first). Any non-date value is treated as relevance.
0-based search results page (0-50). Page forward via meta.nbPages. (0–50)
Search results per page (1-100, default 20). (1–100)
Minimum score (points) filter for search hits. (0–)
Maximum score (points) filter for search hits. (0–)
Minimum comment-count filter for search hits. (0–)
Maximum comment-count filter for search hits. (0–)
Only hits created on/before this date. Accepts a unix timestamp or an ISO date (YYYY-MM-DD).
Only hits created on/after this date. Accepts a unix timestamp or an ISO date (YYYY-MM-DD).
Advanced: raw Algolia numericFilters string, appended to the built min/max/date filters (e.g. 'points>100,created_at_i>1700000000').
Advanced: restrictSearchableAttributes — limit matching to given Algolia fields (e.g. 'title' or 'title,story_text').
curl -X POST https://api.reefapi.com/hackernews/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"python","tags":"story"}'Hit Send to run this endpoint live.