LinkedIn search jobs API

Search LinkedIn jobs

curl --request POST \
  --url https://api.stophy.dev/v1/linkedin/jobs/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "software engineer",
  "location": "United States",
  "datePosted": "pastWeek",
  "company": [
    "1441",
    "1586"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'software engineer',
    location: 'United States',
    datePosted: 'pastWeek',
    company: ['1441', '1586']
  })
};

fetch('https://api.stophy.dev/v1/linkedin/jobs/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/linkedin/jobs/search"

payload = {
    "query": "software engineer",
    "location": "United States",
    "datePosted": "pastWeek",
    "company": ["1441", "1586"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobUrl": "<string>",
        "jobId": "<string>",
        "title": "<string>",
        "companyName": "<string>",
        "companyUrl": "<string>",
        "companyAvatarUrl": "<string>",
        "location": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "salaryMin": 123,
        "salaryMax": 123,
        "salaryCurrency": "<string>",
        "salaryPeriod": "hour",
        "salaryText": "<string>",
        "isEasyApply": true,
        "insight": "<string>"
      }
    ],
    "page": 0
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

jobs

Search LinkedIn jobs

curl --request POST \
  --url https://api.stophy.dev/v1/linkedin/jobs/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "software engineer",
  "location": "United States",
  "datePosted": "pastWeek",
  "company": [
    "1441",
    "1586"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'software engineer',
    location: 'United States',
    datePosted: 'pastWeek',
    company: ['1441', '1586']
  })
};

fetch('https://api.stophy.dev/v1/linkedin/jobs/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/linkedin/jobs/search"

payload = {
    "query": "software engineer",
    "location": "United States",
    "datePosted": "pastWeek",
    "company": ["1441", "1586"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "jobUrl": "<string>",
        "jobId": "<string>",
        "title": "<string>",
        "companyName": "<string>",
        "companyUrl": "<string>",
        "companyAvatarUrl": "<string>",
        "location": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "salaryMin": 123,
        "salaryMax": 123,
        "salaryCurrency": "<string>",
        "salaryPeriod": "hour",
        "salaryText": "<string>",
        "isEasyApply": true,
        "insight": "<string>"
      }
    ],
    "page": 0
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Searches LinkedIn jobs.

Request

This method has no required parameters.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.linkedin.jobs.search({ query: "software engineer", location: "United States", datePosted: "pastWeek", company: ["1441", "1586"] });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.linkedin.jobs.search(query="software engineer", location="United States", date_posted="pastWeek", company=["1441", "1586"])
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/linkedin/jobs/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"software engineer","location":"United States","datePosted":"pastWeek","company":["1441","1586"]}'

stophy linkedin jobs search "software engineer" --location "United States" --datePosted pastWeek --company 1441,1586

Response

If successful, the response body contains the standard envelope. data.results[] contains the jobs, each with its company, location and posting date. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "results": [
      {
        "jobId": "4471906326",
        "jobUrl": "https://www.linkedin.com/jobs/view/4471906326",
        "title": "Software Engineer III, Foundation Services, Google Cloud",
        "companyName": "Google",
        "companyUrl": "https://www.linkedin.com/company/google",
        "companyAvatarUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQGv3cqOuUMY7g/company-logo_100_100/B4EZmhegXHGcAU-/0/1759350753990/google_lo…",
        "location": "Kirkland, WA",
        "publishedAt": "2026-09-29T00:00:00.000Z",
        "insight": "Actively Hiring"
      }
    ],
    "page": 1
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`page`	integer	The page number of this response.
`publishedAt`	string (ISO 8601)	The publication time, in UTC.

For every field, see the response schema on this page.

Optional parameters

Parameter	Type	Description
`query`	string	Words to search for.
`location`	string	The city or area to search in.
`datePosted`	string	Restricts results to jobs posted in this period. Acceptable values are `anyTime`, `pastMonth`, `pastWeek` and `past24Hours`. If unset, defaults to `anyTime`.
`company`	object	One company, or up to five. Use LinkedIn links, slugs such as `google`, or company ids. Accepts a string or an array of 1 to 5 strings.
`easyApply`	boolean	Restricts results to Easy Apply jobs. If unset, defaults to `false`.
`fewApplicants`	boolean	Restricts results to jobs with fewer than 10 applicants. If unset, defaults to `false`.
`page`	integer	The page to return. Pages are numbered from 1. Must be between 1 and 100. If unset, defaults to `1`.

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, increment page. An empty data.results indicates the last page. The maximum value of page is 100.

LinkedIn job: Accepts jobUrl. Returns a LinkedIn job’s details.
LinkedIn company: Accepts companyUrl. Returns a company’s profile, size and industry.
LinkedIn posts: Accepts companyUrl. Returns a person’s or company’s latest public posts.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query

string

Maximum string length: 200

location

string

Maximum string length: 200

datePosted

enum<string>

default:anyTime

LinkedIn's own Date posted.

Available options:

anyTime,

pastMonth,

pastWeek,

past24Hours

company

One company or up to five: LinkedIn URLs, slugs like google, or company ids.

easyApply

boolean

default:false

LinkedIn's own Easy Apply.

fewApplicants

boolean

default:false

LinkedIn's own Under 10 applicants.

page

integer

default:1

Page number, starting at 1.

Required range: 1 <= x <= 100

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

LinkedIn search jobs API

Request

Response

Optional parameters

Billing

Authorizations

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

​Related methods

Authorizations

Body

Response

Request

Response

Optional parameters

Billing

Pagination

Related methods