List Hacker News user favorites
List favorites for a Hacker News user by username.
Headers
Get your API keyAPI key (`sfk_...`)
Hacker News username (case-sensitive).
min 1 chars · max 255 chars · pattern: ^[A-Za-z0-9_-]+$
One-based HTML favorites page number. Default: 1. Each page bills 1 credit.
≥ 1 · ≤ 100
Endpoint-specific response payload.
Whether public favorites were found, the user/page was missing, or favorites are private/unavailable.
one of: found, not_found, private_or_unavailable
User summary when favorites are public; null for not_found / private_or_unavailable.
Hacker News username.
min 1 chars
Canonical news.ycombinator.com user URL.
Favorited items when available.
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.
Pagination metadata when found; null otherwise.
Requested HTML page number.
≥ 0
Number of hydrated favorites returned.
≥ 0
True when the HTML page indicates another favorites page.
Parsed ids that could not be hydrated.
≥ 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/users/tptacek/favorites" \
-H "x-api-key: YOUR_API_KEY"Responses
Public favorites page.