Hacker News

List Who is Hiring jobs

List top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month).

GET/v1/hackernews/jobs/who-is-hiring
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
monthstringquery

Calendar month (YYYY-MM) to pin a Who is Hiring thread. Default: latest thread.

pattern: ^\d{4}-(0[1-9]|1[0-2])$

pageintegerquery

Zero-based page index of top-level hiring comments.

≥ 0 · ≤ 49

pageSizeintegerquery

Job rows per page (1–50). Default: 20.

≥ 1 · ≤ 50

Response fields
31

Endpoint-specific response payload.

datalookupStatus
string

Whether a matching Who is Hiring thread was found.

one of: found, not_found

Thread summary when found.

datathreadid
integer

Story id of the hiring thread.

≥ 0

datathreadtitle
stringnullable

Thread title.

datathreadcreatedAt
stringnullable

Thread creation time.

datathreaditemUrl
string

Canonical news.ycombinator.com item URL.

Top-level hiring comments as structured rows.

dataitems[]commentId
integer

Hiring comment id.

≥ 0

dataitems[]author
stringnullable

Comment author username.

dataitems[]createdAt
stringnullable

Comment creation time.

dataitems[]text
stringnullable

Full plain-text hiring comment (HTML stripped).

dataitems[]company
stringnullable

Best-effort company name parse; null when unknown.

dataitems[]role
stringnullable

Best-effort role/title parse; null when unknown.

dataitems[]location
stringnullable

Best-effort location parse; null when unknown.

dataitems[]remote
booleannullable

Best-effort remote signal; null when unknown.

dataitems[]salary
stringnullable

Best-effort salary snippet; null when unknown.

dataitems[]visa
booleannullable

Best-effort visa sponsorship signal; null when unknown.

dataitems[]contact
stringnullable

Best-effort contact snippet; null when unknown.

dataitems[]itemUrl
string

Canonical news.ycombinator.com item URL.

Pagination metadata when found.

datapagepage
integer

Zero-based page index.

≥ 0

datapagepageSize
integer

Requested job rows per page.

≥ 0

datapagereturned
integer

Number of job rows returned in this page.

≥ 0

datapagehasMore
boolean

True when another page is available within the accessible window.

datapagenextPage
integernullable

Next page index when hasMore is true; otherwise null.

≥ 0

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/jobs/who-is-hiring" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Structured Who is Hiring page.