$ man hacker-news-search
/hacker-news-search(1)
PRICE / CALL
$0.001
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
hacker-news-search — hacker news search / hn search / yc-news / algolia hn
synonym alias of hn-search — reuses the canonical handler.
SYNOPSIS
POST https://x402.org/v1/hacker-news-search
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Hacker News search / HN search / yc-news / Algolia HN. Searches 30M+ Hacker News stories and comments. Filter by type (story/comment/poll), author, min points, ISO8601 date range; sort by relevance or recency. Returns title, author, points, comment count, URL.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| query | string | Free-text search query (matches title, body, author, URL). | required |
| type | string | Restrict to a single HN item type. Omit to include all types. enum: story · comment · poll | optional |
| author | string | Filter to a specific HN username (e.g. 'pg', 'dang'). | optional |
| min_points | number | Minimum points (upvotes) floor. Comments don't have points; using this implicitly filters to stories. | optional |
| since | string | Lower bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp. | optional |
| until | string | Upper bound on created_at — ISO8601 date (YYYY-MM-DD) or full timestamp. | optional |
| sort | string | 'relevance' (default, popularity-weighted) or 'date' (most-recent-first). enum: relevance · date | optional |
| limit | number | Max hits to return. 1-20. Default 10. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| query | string | Echoes back the search query string that was submitted to the Algolia HN index. |
| total_hits | string | Total number of HN stories or comments matching the query before pagination. |
| results | string | Array of matching HN items with title, author, points, comment count, URL, and timestamp. |
| source | string | Upstream data source identifier, typically 'algolia-hn' for the HN Search API. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/hacker-news-search \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the hacker-news-search tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- hacker-newshn-searchtech-newsalgolia-hnstory-searchcomment-searchyc-news
- methods
- POST
- cluster
- webprobe
- price
- $0.001 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| hn-search | HN search / Hacker News search / yc-news / startup-news search / Algolia HN / who-is-hiring scraper / programmer-news firehose. | $0.001 |
| ip-asn | IP to ASN / IP geolocation / IP-to-ISP lookup / WHOIS for IP / cloud-provider attribution. | $0.001 |
| qr-code-generate | QR code generator / QR maker / vCard QR / WiFi QR / URL to QR / SVG QR / PNG QR / customizable error correction. | $0.001 |
| tld-info | TLD info / top-level domain registry lookup / ccTLD vs gTLD / TLD introduction year / new gTLD registry. | $0.001 |
| user-agent-parse | User-Agent parser / UA classifier / browser detection / OS detection / bot detection / AI crawler identifier (GPTBot, ClaudeBot, Perplexi… | $0.001 |
| arxiv-bibtex | arXiv to BibTeX / arxiv citation generator / paper bibtex / LaTeX citation builder / academic citation lookup. | $0.002 |
| github-readme | GitHub README fetch / repo readme / open-source-readme-as-markdown / package documentation puller. | $0.002 |
| keyword-suggest | Keyword autocomplete / search suggest / SEO keyword research / query expansion / autocomplete suggestions. | $0.002 |
SEE ALSO