List Hacker News user submissions
List a Hacker News user's stories, polls, and jobs (newest first).
Headers
Get your API keyAPI key (`sfk_...`)
Hacker News username (case-sensitive).
min 1 chars · max 255 chars · pattern: ^[A-Za-z0-9_-]+$
Zero-based page index (maximum 50 pages, up to 1,000 hits).
≥ 0 · ≤ 49
Hits per page (1–50). Default: 20.
≥ 1 · ≤ 50
Endpoint-specific response payload.
Whether the user was found or not found.
one of: found, not_found
User summary when found; null when not_found.
Hacker News username.
min 1 chars
Canonical news.ycombinator.com user URL.
Non-comment submissions (stories, jobs, polls, …) newest-first.
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 when not_found.
Zero-based page index.
≥ 0
Requested hits per page.
≥ 0
Number of items returned in this page.
≥ 0
True when another page is available within the accessible window.
Next page index when hasMore is true; otherwise null.
≥ 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/submissions" \
-H "x-api-key: YOUR_API_KEY"Responses
User submissions page.