Social Fetch
LinkedIn

Get LinkedIn jobs

Get LinkedIn job postings by URL.

GET/v1/linkedin/jobs
2creditsper URL
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
url*arrayquery

LinkedIn job posting URL to look up.

Response fields
48

Endpoint-specific response payload.

Per-URL job lookup results.

dataresults[]url
string

Requested job URL echoed for this result.

min 1 chars

dataresults[]lookupStatus
string

Domain outcome of one job lookup in the batch.

one of: found, not_found, error

Error details when `lookupStatus` is `error`.

dataresults[]errormessage
string

Short customer-safe reason this job could not be returned.

min 1 chars

Job details when available.

dataresults[]jobid
stringnullable

Unique identifier for the job listing when available.

dataresults[]joburl
string

Public URL for the job posting on LinkedIn.

min 1 chars

dataresults[]jobtitle
stringnullable

Title of the advertised job position.

dataresults[]jobcompanyName
stringnullable

Name of the hiring company.

dataresults[]jobcompanyId
stringnullable

Unique identifier for the hiring company when available.

dataresults[]jobcompanyUrl
stringnullable

LinkedIn profile link of the hiring company.

dataresults[]joblocation
stringnullable

Geographic location of the job.

dataresults[]jobsummary
stringnullable

Brief overview of job responsibilities.

dataresults[]jobseniorityLevel
stringnullable

Seniority level of the position.

dataresults[]jobfunction
stringnullable

Department or function of the job.

dataresults[]jobemploymentType
stringnullable

Type of employment offered.

dataresults[]jobindustries
stringnullable

Industries associated with the job.

dataresults[]jobbasePayRange
stringnullable

Salary range text for the position when available.

dataresults[]jobpostedAt
stringnullable

When the job was posted (relative or absolute label from LinkedIn).

dataresults[]jobpostedDate
stringnullable

ISO-8601 posting timestamp when available.

dataresults[]jobapplicantCount
integernullable

Number of applicants for the job.

≥ 0

LinkedIn member who posted the job when available.

dataresults[]jobjobPostername
stringnullable

Job poster's display name on LinkedIn.

dataresults[]jobjobPostertitle
stringnullable

Job poster's current role or title.

dataresults[]jobjobPosterprofileUrl
stringnullable

Job poster's LinkedIn profile URL.

dataresults[]jobapplicationAvailable
booleannullable

Whether a user can still apply for this job.

dataresults[]jobdescriptionFormatted
stringnullable

Job description as formatted on LinkedIn.

Structured base pay range when available.

dataresults[]jobbaseSalaryminAmount
numbernullable

Minimum base pay amount when available.

dataresults[]jobbaseSalarymaxAmount
numbernullable

Maximum base pay amount when available.

dataresults[]jobbaseSalarycurrency
stringnullable

Payment currency symbol or code when available.

dataresults[]jobbaseSalarypaymentPeriod
stringnullable

Pay interval for the base salary when available.

dataresults[]jobsalaryStandards
stringnullable

Employer-provided pay standards or notes.

dataresults[]jobisEasyApply
booleannullable

Whether LinkedIn Easy Apply is available.

dataresults[]jobapplyLink
stringnullable

Direct apply link when provided by LinkedIn.

dataresults[]jobcountryCode
stringnullable

Two-letter country code when available.

dataresults[]jobcompanyLogoUrl
stringnullable

Company logo image URL when available.

Summary counts for the job batch.

datasummaryrequestedUrls
integer

Number of job URLs requested in this batch.

≥ 0

datasummaryfound
integer

Number of jobs successfully found.

≥ 0

datasummarynotFound
integer

Number of jobs that were not found.

≥ 0

datasummaryerrored
integer

Number of jobs that failed to resolve.

≥ 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

Code example

curl "https://api.socialfetch.dev/v1/linkedin/jobs?url=https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804/" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Batch lookup results. Inspect each `data.results[].lookupStatus` for `found`, `not_found`, or `error`.

On this page

No Headings