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.
platformstringPlatform ID (linkedin, …).
idstringPlatform-native job ID (string; LinkedIn's numeric job ID).
urlstring uriCanonical job page URL (https://www.linkedin.com/jobs/view/<id>/).
titlestringThe job's title as the employer wrote it.
employerobjectnullableThe 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
idstringnullablePlatform-native account ID; null when only the handle is known.
usernamestringnullableHandle without the @; null when the account has none.
display_namestringnullableDisplay name shown on the profile.
urlstring urinullableCanonical profile URL.
avatar_urlstring urinullableProfile picture URL. Platform CDN URLs can expire within hours.
is_verifiedbooleannullablePlatform verification badge; null where the platform has no badge.
descriptionstringnullableThe 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
namestringThe location as the board shows it, one line (San Francisco, CA; London Area, United Kingdom; United States).
citystringnullableCity, as shown; null when the location is wider than a city or the board does not give one.
regionstringnullableState, province or region, as shown (NY, Ontario); null when not given.
country_codestringnullableISO 3166-1 alpha-2 country; null when the board does not give one or the location spans several.
workplace_typestringnullableWhere 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
senioritystringnullableThe 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.
salaryobjectnullableThe pay stated for the job; null when none is stated.
ShowHide 5 child fields
minnumbernullableLowest 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").
maxnumbernullableHighest 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").
currencystringISO 4217 code of both amounts (USD).
periodstringnullableWhat 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_estimatedbooleannullableThe 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-timenullableWhen 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-timenullableWhen the posting is set to close, RFC 3339 UTC; null when the board shows no end.
is_closedbooleannullableThe 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_applybooleannullableApplied 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 urinullableThe 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.
metricsobjectCounts at fetch time; null = hidden or not exposed, 0 = zero.
ShowHide 1 child field
applicant_countintegernullablePeople 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_specificobjectFields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.
ShowHide 2 child fields
linkedinobjectnullableA LinkedIn job's own fields.
ShowHide 3 child fields
title_idstringnullableID 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
idstringnullablePlatform-native account ID; null when only the handle is known.
usernamestringnullableHandle without the @; null when the account has none.
display_namestringnullableDisplay name shown on the profile.
urlstring urinullableCanonical profile URL.
avatar_urlstring urinullableProfile picture URL. Platform CDN URLs can expire within hours.
is_verifiedbooleannullablePlatform verification badge; null where the platform has no badge.
hackernewsobjectnullableA Hacker News job's own fields.
ShowHide 4 child fields
posterobjectnullableThe Hacker News account that posted the job: often a founder, a hiring manager or a recruiter at the company.
ShowHide 6 child fields
idstringnullablePlatform-native account ID; null when only the handle is known.
usernamestringnullableHandle without the @; null when the account has none.
display_namestringnullableDisplay name shown on the profile.
urlstring urinullableCanonical profile URL.
avatar_urlstring urinullableProfile picture URL. Platform CDN URLs can expire within hours.
is_verifiedbooleannullablePlatform verification badge; null where the platform has no badge.
threadobjectnullableThe monthly Who is hiring thread the job was posted in.
ShowHide 3 child fields
idstringThe thread's item ID.
titlestringnullableThe thread's title (Ask HN: Who is hiring? (November 2026)).
urlstring uriThe thread's page on Hacker News.
headerstringnullableThe 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_sponsoredbooleannullableThe 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:
| Code | HTTP | Retry | Meaning | What to do |
|---|---|---|---|---|
not_found | 404 | No | The 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. |