List a Hacker News feed
List a Hacker News feed by type (top, new, best, ask, show, or jobs).
Headers
Get your API keyAPI key (`sfk_...`)
Hacker News feed: top, new, best, ask, show, or jobs.
one of: top, new, best, ask, show, jobs
Zero-based page index (maximum 50 pages). Default: 0. Advance with `data.page.nextPage` when `hasMore` is true.
≥ 0 · ≤ 49
Items to hydrate per page (1–50). Default: 30. Prefer this over `pageSize`.
≥ 1 · ≤ 50
Endpoint-specific response payload.
Requested feed name.
one of: top, new, best, ask, show, jobs
Hydrated feed items in official ranking order.
Unique Hacker News item id.
≥ 0
Item type.
one of: story, comment, job, poll, pollopt, unknown
Author username when present.
Creation time as an ISO-8601 timestamp.
Plain-text title when present.
Plain-text body when present (HTML stripped).
External URL when present and publicly safe.
Score / votes when present.
Total comment count when present (stories/polls).
Parent item id for comments/pollopts.
≥ 0
Child item ids in ranked display order when present. Some list endpoints omit children and return an empty array.
≥ 0
Whether the item is marked dead. Some list endpoints omit this signal and return false.
Whether the item is marked deleted. Some list endpoints omit this signal and return false.
Canonical news.ycombinator.com item URL.
Feed pagination metadata.
Zero-based page index for this response.
≥ 0
Requested page size for this response.
≥ 0
Number of hydrated items returned.
≥ 0
Length of the upstream feed id array.
≥ 0
True when more ids remain after this page window.
Next page index when hasMore is true; otherwise null.
≥ 0
Ids in the window that could not be hydrated (deleted/missing).
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/hackernews/feeds/top" \
-H "x-api-key: YOUR_API_KEY"Responses
Hydrated feed page.