Skip to main content
POST /v1/data/hackernews/stories/run Pricing: $0.01 per storie ($10.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
default:"top"
Which Hacker News list to read: Top, New, Best, Ask HN or Show HN. Top by default.Allowed values: top (Top Stories), new (New Stories), best (Best Stories), ask (Ask HN), show (Show HN).
string
Search stories by keyword, e.g. openai. Leave empty to read the chosen feed.
string
Order of search results (only used with a Search Query).Allowed values: relevance (Relevance), date (Date (newest first)).
integer
default:"100"
How many stories to return in total. Defaults to 100; use 0 for all.Max 500.

Example

Response fields

Each row in data is one storie, keyed by these fields.

Example response

Abridged: long text and lists are shortened.