Hacker News

Get Hacker News story

Get a Hacker News story by id.

GET/v1/hackernews/stories/{id}
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
id*integerpath

Hacker News story id.

≥ 0 · ≤ 9007199254740991

Response fields
21

Endpoint-specific response payload.

datalookupStatus
string

Whether the story was found, not found, or not a story.

one of: found, not_found, not_story

Story when lookupStatus is `found`; null when `not_found` or `not_story`.

datastoryid
integer

Unique Hacker News story id.

≥ 0

datastoryauthor
stringnullable

Author username when present.

datastorycreatedAt
stringnullable

Creation time as an ISO-8601 timestamp.

datastorytitle
stringnullable

Plain-text title when present.

datastorytext
stringnullable

Plain-text body when present (HTML stripped).

datastoryurl
stringnullable

External story URL when present and publicly safe.

datastoryscore
integernullable

Score / votes when present.

datastorycommentCount
integernullable

Total comment count when present.

Top-level comment ids in ranked display order.

datastorychildIds[]
integeroptional

≥ 0

datastorydead
boolean

Whether the story is marked dead.

datastorydeleted
boolean

Whether the story is marked deleted.

datastoryitemUrl
string

Canonical news.ycombinator.com item URL.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

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/stories/8863" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Hacker News story lookup result.