Unif API Docs

List Hacker News story items

Fetch item details from a named Hacker News story feed in one operation. Use this when an agent needs readable story titles, URLs, scores, authors, or comment counts.

Pricing — Free

This endpoint returns billing metadata with zero credits charged.

GET
/hacker-news/stories/{feed}/items

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

feed*string

Story feed: top, new, best, ask, show, or jobs.

Value in

  • "top"
  • "new"
  • "best"
  • "ask"
  • "show"
  • "jobs"

Query Parameters

cursor?string

Zero-based offset cursor returned as next_cursor.

limit?integer
Range1 <= value <= 50
Default20

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/hacker-news/stories/top/items"
{  "request_id": "string",  "data": [    {      "id": 0,      "deleted": true,      "type": "job",      "by": "string",      "time": 0,      "text": "string",      "dead": true,      "parent": 0,      "poll": 0,      "kids": [        0      ],      "url": "string",      "score": 0,      "title": "string",      "parts": [        0      ],      "descendants": 0    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}