Start with 100 free credits. No card needed. Get an API key

LinkedIn job search API

Job ads from LinkedIn Jobs, newest-relevant first as LinkedIn orders them, 10 a page: id, URL, title, company (name, handle, logo), location, the day it...

GET /v1/linkedin/jobs/search

GET /v1/linkedin/jobs/search

Job ads from LinkedIn Jobs, newest-relevant first as LinkedIn orders them, 10 a page: id, URL, title, company (name, handle, logo), location, the day it was posted and, when the card shows them, the pay range and a badge such as "Actively Hiring". Filter by words, place, how recently it was posted and company. Remote, hybrid or on-site, experience level and job type are not offered: LinkedIn ignores those filters for this search and does not print workplace type on the job. Employment type, seniority, function, industry, applicants and the description come from linkedin.job. The cursor runs to page 100 (about 1,000 jobs). A search with no match can still return LinkedIn's nearest jobs, so check the titles.

  • Cost: 1 credit
  • Cache: Results are kept up to 1 day; send max_age_days to reuse them for free.
  • Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters

NameTypeRequiredDescription
querystringnoJob title, skill or other words, as typed into LinkedIn's job search. Also accepted as keyword, q.
locationstringnoPlace as free text: a country, region or city ("United States", "Berlin").
date_postedstringnoOnly jobs posted in this window. One of hour, day, week, month. Also accepted values: past-hour for hour, past-24h for day, past-week for week, past-month for month, last-hour for hour, last-day for day, last-week for week, last-month for month.
company_idstringnoOnly this company's jobs: LinkedIn's numeric company id (the id from linkedin.company, or a job's company.id), several separated by commas. Also accepted as companyId.

Every request also accepts:

  • cursor: the cursor from the previous page (Pagination).
  • trim: true for a smaller response without null fields and extra.
  • raw: true to also get the platform's original object as raw.
  • max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).

Example request

Set your key in the environment first (see Authentication).

curl -G "https://api.socialscrape.dev/v1/linkedin/jobs/search" \
  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \
  --data-urlencode "query=haskell" \
  --data-urlencode "location=Iceland"

Example response

This is a sample from a recorded response, lists and long text are shortened. Status 200.

200 OKSample values
{
  "ok": true,
  "credits_charged": 1,
  "credits_remaining": 4999,
  "cached": false,
  "cached_at": null,
  "request_id": "req_f656c94628164e4eafb08407",
  "data": {
    "object": "list",
    "items": [
      {
        "object": "job_posting",
        "platform": "linkedin",
        "id": "4474579813",
        "url": "https://www.linkedin.com/jobs/view/4474579813",
        "title": "Account Executive - Portfolio",
        "company": {
          "id": null,
          "handle": "cisco",
          "name": "Cisco",
          "url": "https://www.linkedin.com/company/cisco",
          "avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQFYnR_Zrm87Dg/company-logo_100_100/B56ZnMyVr4HUAQ-/0/1760077372453/cisco_logo?e=2147483647&v=beta&t=-FnJBwOSzJBs2mZI3Vt8hsrLNZhBuwEXpMas5hClACE",
          "verified": null
        },
        "location": "Reykjavík, Capital Region, Iceland",
        "description": null,
        "employment_type": null,
        "seniority": null,
        "job_function": null,
        "industry": null,
        "salary": null,
        "applicant_count": null,
        "published_at": "2026-11-13T00:00:00Z",
        "approximate": [
          "published_at"
        ],
        "extra": {
          "badge": "Actively Hiring",
          "posted_text": "4 days ago"
        }
      },
      {
        "object": "job_posting",
        "platform": "linkedin",
        "id": "4486828688",
        "url": "https://www.linkedin.com/jobs/view/4486828688",
        "title": "Director Finance, Fish",
        "company": {
          "id": null,
          "handle": "jbtmarel",
          "name": "JBT Marel",
          "url": "https://www.linkedin.com/company/jbtmarel",
          "avatar_url": "https://media.licdn.com/dms/image/v2/D4D0BAQGptuQ1S7Jx9g/company-logo_100_100/company-logo_100_100/0/1736163017847/jbtmarel_logo?e=2147483647&v=beta&t=HVRjSV6SGdnI-Vtm1pLJMap7f9OdWc-_2ZRrxf2-l9g",
          "verified": null
        },
        "location": "Garðabær, Capital Region, Iceland",
        "description": null,
        "employment_type": null,
        "seniority": null,
        "job_function": null,
        "industry": null,
        "salary": null,
        "applicant_count": null,
        "published_at": "2026-11-03T00:00:00Z",
        "approximate": [
          "published_at"
        ],
        "extra": {
          "badge": "Be an early applicant",
          "posted_text": "2 weeks ago"
        }
      }
    ],
    "cursor": null,
    "has_more": false,
    "parent": null
  },
  "cursor": null,
  "has_more": false
}

Response

A list of JobPosting objects in data.items, with data.cursor and data.has_more.

See Data models for every field. The envelope around data is described in Responses.

Errors

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

CodeHTTPRetryMeaning
invalid_params400noA parameter is missing, unknown or has the wrong type.
not_found404noThe platform says this profile, post or item does not exist.

Every request can also fail with the account and platform errors listed on the Errors page.