Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hacker News Lists API

Top, new, best, ask, show, and job story lists.

Hacker News Lists API is one of 4 APIs that Hacker News publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Lists. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 6 paths. It is described by OpenAPI 3.0.3, at version v0.

Requests are made against a single base URL, https://hacker-news.firebaseio.com/v0.

6 operations 6 paths 0 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v0
Base URL
https://hacker-news.firebaseio.com
License
Resource Areas
1

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

Lists 6

Top, new, best, ask, show, and job story lists.

GET
/topstories.json
Get top stories
getTopStories → 200
GET
/newstories.json
Get new stories
getNewStories → 200
GET
/beststories.json
Get best stories
getBestStories → 200
GET
/askstories.json
Get latest Ask HN stories
getAskStories → 200
GET
/showstories.json
Get latest Show HN stories
getShowStories → 200
GET
/jobstories.json
Get latest job stories
getJobStories → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hacker-news-lists-api-openapi.yml Raw ↑

Other APIs Hacker News publishes across the network.

Hacker News Items API
Hacker News Live API
Hacker News Users API