$ man hn-search
/hn-search(1)
PRICE / CALL
$0.001
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
hn-search — hn search / hacker news search / yc-news / startup-news search / algolia hn / who-is-hiring scraper / programmer-news firehose
SYNOPSIS
POST https://x402.org/v1/hn-search
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
HN search / Hacker News search / yc-news / startup-news search / Algolia HN / who-is-hiring scraper / programmer-news firehose. Searches 30M+ Hacker News stories and comments via the public Algolia HN index. Filter by type (story|comment|poll), author, minimum points, ISO8601 date range (since/until), and sort by relevance or recency. Returns total hit count plus per-hit objectID, title, author, points, comment count, created_at, URL, and story/comment text. Public Algolia API — no auth, commercial-OK.
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 is applied. |
| results | string | Array of hit objects with objectID, title, author, points, num_comments, created_at, url, and story/comment text. |
| source | string | Identifier for the upstream index queried, typically the Algolia HN search endpoint. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/hn-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 hn-search tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probehacker-newshn-searchalgolia-hnstory-searchwho-is-hiringyc-news
- methods
- POST
- cluster
- webprobe
- price
- $0.001 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| hacker-news-search | Hacker News search / HN search / yc-news / Algolia HN. | $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