Search Hacker News

PythonTools

POST api.upapi.io/hackernews-search.get

Full-text + filter search over Hacker News (stories, comments, Show/Ask HN, front page) via Algolia's open API. Ordered by relevance or date.

hackernewsnewssearchpython

AuthAPI key

Cost1 unit

Timeout20s

Cache60s

Request schema

Field	Type	Description
`tags`	string	HN Algolia tag filter: story, comment, poll, show_hn, ask_hn, front_page, etc.· default: `"story"`
`order`	string	Sort order· default: `"relevance"`
`query`req	string	Full-text search query
`hitsPerPage`	integer	· default: `20`

Response schema

Field	Type	Description
`hits`req	array
`query`req	string
`fetchedAt`req	string
`totalHits`req	integer

Try it

queryrequired

Full-text search query

tagsoptional· default: story

HN Algolia tag filter: story, comment, poll, show_hn, ask_hn, front_page, etc.

orderoptional· default: relevance

Sort order

hitsPerPageoptional· default: 20

Run this endpoint live

Jump in as a guest — no signup — and run hackernews-search.get with your own inputs. Create a free account anytime to get your own API key.

Code examples

curl -X POST https://api.upapi.io/hackernews-search.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "tags": "story", "order": "relevance", "query": "typescript", "hitsPerPage": 20 }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.