Hacker News

Get Hacker News item

Get a Hacker News item by id.

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

API key (`sfk_...`)

Parameters
1
id*integerpath

Hacker News item id.

≥ 0 · ≤ 9007199254740991

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found or not found.

one of: found, not_found

Item when lookupStatus is `found`; null when `not_found`.

dataitemid
integer

Unique Hacker News item id.

≥ 0

dataitemtype
string

Item type.

one of: story, comment, job, poll, pollopt, unknown

dataitemauthor
stringnullable

Author username when present.

dataitemcreatedAt
stringnullable

Creation time as an ISO-8601 timestamp.

dataitemtitle
stringnullable

Plain-text title when present.

dataitemtext
stringnullable

Plain-text body when present (HTML stripped).

dataitemurl
stringnullable

External URL when present and publicly safe.

dataitemscore
integernullable

Score / votes when present.

dataitemcommentCount
integernullable

Total comment count when present (stories/polls).

dataitemparentId
integernullable

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.

dataitemchildIds[]
integeroptional

≥ 0

dataitemdead
boolean

Whether the item is marked dead. Some list endpoints omit this signal and return false.

dataitemdeleted
boolean

Whether the item is marked deleted. Some list endpoints omit this signal and return false.

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

Responses

Item lookup result.