Schemas

Job postings with the title, employer, location and workplace type, employment type, seniority, salary range, description, posting date, whether it is closed, applicants and apply link.

Endpoints

5 endpoints return jobs on Hacker News and LinkedIn.

Schema

Single-item endpoints return this object as data; list endpoints return an array of them as data with a page object. The standard meta comes with every response.

platformstring

Platform ID (linkedin, …).

idstring

Platform-native job ID (string; LinkedIn's numeric job ID).

urlstring uri

Canonical job page URL (https://www.linkedin.com/jobs/view/<id>/).

titlestring

The job's title as the employer wrote it.

employerobjectnullable

The company (or person) hiring, as the board names it: its account on the platform when it has one; null when the board does not say who is hiring (a confidential posting, an Upwork client).

ShowHide 6 child fields
idstringnullable

Platform-native account ID; null when only the handle is known.

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name shown on the profile.

urlstring urinullable

Canonical profile URL.

avatar_urlstring urinullable

Profile picture URL. Platform CDN URLs can expire within hours.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

descriptionstringnullable

The full description as plain text, line breaks kept (paragraphs and list items each on their own line); null when the board shows none.

locationsobject[]

Where the job is based, the main location first, as the board shows them; [] when none is shown (a remote job with no location), listed in unknown_fields when the source cannot see them.

ShowHide 4 child fields
namestring

The location as the board shows it, one line (San Francisco, CA; London Area, United Kingdom; United States).

citystringnullable

City, as shown; null when the location is wider than a city or the board does not give one.

regionstringnullable

State, province or region, as shown (NY, Ontario); null when not given.

country_codestringnullable

ISO 3166-1 alpha-2 country; null when the board does not give one or the location spans several.

workplace_typestringnullable

Where the work is done: on_site, hybrid (partly remote) or remote; null when the board does not say. New values may be added; treat unknown values as null.

One ofon_sitehybridremote

employment_typesstring[]

The terms of employment, in the order the board gives them (a posting may name several: full_time and part_time): full_time, part_time, contract (freelance and contractor roles), temporary (seasonal too), internship, volunteer, other; [] when the board does not say (listed in unknown_fields when the source cannot see them). New values may be added; treat unknown values as other.

One offull_timepart_timecontracttemporaryinternshipvolunteerother

senioritystringnullable

The experience level asked for, as the board labels it (Entry level, Mid-Senior level, Expert; not normalized: each board has its own scale); null when not stated.

salaryobjectnullable

The pay stated for the job; null when none is stated.

ShowHide 5 child fields
minnumbernullable

Lowest pay of the range, in major units of currency per period; equal to max for a single figure; null when only a maximum is stated ("up to $90,000").

maxnumbernullable

Highest pay of the range, in major units of currency per period; equal to min for a single figure; null when only a minimum is stated ("from $40/hr").

currencystring

ISO 4217 code of both amounts (USD).

periodstringnullable

What one amount pays for: an hour, day, week, month or year of work, or total (a fixed price for the whole job, as an Upwork fixed-price budget); null when the board does not say. New values may be added; treat unknown values as null.

One ofhourdayweekmonthyeartotal

is_estimatedbooleannullable

The board estimated the pay itself rather than the employer stating it; false when the employer stated it; null when the board does not say.

industriesstring[]

The industries the board files the job under, as shown (not normalized), the main one first; [] when none is shown.

job_functionsstring[]

The kinds of work the board files the job under (Engineering, Sales), as shown (not normalized); [] when none is shown.

skillsstring[]

Skills the posting asks for, as the board tags them; [] when none (listed in unknown_fields when the source cannot see them).

benefitsstring[]

Benefits the posting lists (Health insurance, 401(k)), as shown; [] when none (listed in unknown_fields when the source cannot see them).

published_atstring date-timenullable

When the job was posted (its latest listing when reposted), RFC 3339 UTC; a date or relative label ("2 weeks ago") is listed in approximate_fields; null when not shown.

expires_atstring date-timenullable

When the posting is set to close, RFC 3339 UTC; null when the board shows no end.

is_closedbooleannullable

The job no longer accepts applications, as the board says at fetch time; false when it still does; null when the board does not say.

is_easy_applybooleannullable

Applied for on the platform itself (LinkedIn's and Glassdoor's Easy Apply, Indeed Apply, an Upwork proposal); false when the application is on the employer's site (apply_url); null when not shown.

apply_urlstring urinullable

The employer's application page, for a job applied for off the platform (is_easy_apply false); null for one applied for on the platform, or when the board does not show the link.

metricsobject

Counts at fetch time; null = hidden or not exposed, 0 = zero.

ShowHide 1 child field
applicant_countintegernullable

People who applied, as the board counts them (a bucket such as "Over 200 applicants" gives its bound, listed in approximate_fields); null when not shown.

platform_specificobject

Fields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.

ShowHide 2 child fields
linkedinobjectnullable

A LinkedIn job's own fields.

ShowHide 3 child fields
title_idstringnullable

ID of the standardized title LinkedIn files the job under (9: Software Engineer), as its job search's f_T filter takes it; null when not shown.

industry_idsstring[]

IDs of the industries LinkedIn files the job under (43: Financial Services), as its job search's f_I filter takes them, in the order of industries; [] when none is shown (listed in unknown_fields when the source cannot see them).

hiring_teamobject[]

The members LinkedIn names as hiring for the job (the recruiter or hiring manager who posted it), the poster first; [] when none is shown (listed in unknown_fields when the source cannot see them).

ShowHide 6 child fields
idstringnullable

Platform-native account ID; null when only the handle is known.

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name shown on the profile.

urlstring urinullable

Canonical profile URL.

avatar_urlstring urinullable

Profile picture URL. Platform CDN URLs can expire within hours.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

hackernewsobjectnullable

A Hacker News job's own fields.

ShowHide 4 child fields
posterobjectnullable

The Hacker News account that posted the job: often a founder, a hiring manager or a recruiter at the company.

ShowHide 6 child fields
idstringnullable

Platform-native account ID; null when only the handle is known.

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name shown on the profile.

urlstring urinullable

Canonical profile URL.

avatar_urlstring urinullable

Profile picture URL. Platform CDN URLs can expire within hours.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

threadobjectnullable

The monthly Who is hiring thread the job was posted in.

ShowHide 3 child fields
idstring

The thread's item ID.

titlestringnullable

The thread's title (Ask HN: Who is hiring? (November 2026)).

urlstring uri

The thread's page on Hacker News.

headerstringnullable

The job's first line as the poster wrote it (Company | Role | Location | REMOTE | Full-time | salary, by the thread's convention), from which title, employer, locations, workplace_type, employment_types and salary are read.

is_visa_sponsoredbooleannullable

The first line says the job sponsors a visa (VISA, visa sponsorship); false when it says it doesn't; null when it says neither.

approximate_fieldsstring[]

JSON paths of values rounded by the platform or parsed from display text ("Over 200 applicants": metrics.applicant_count; "2 weeks ago": published_at). [] when all exact.

unknown_fieldsstring[]

JSON paths of lists whose [] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. [] when every list is known.

Item errors

Besides the request-level errors every endpoint can return, job endpoints return:

CodeHTTPRetryMeaningWhat to do
not_found404NoThe item does not exist or was deleted. On GET /v1/requests/{id}/response: the response was not kept (details.reason says why).Check the link or ID. Do not retry.

Last updated