Skip to main content
GET
/
linkedin
/
job-search
Search LinkedIn jobs
curl --request GET \
  --url https://api.harvest-api.com/linkedin/job-search \
  --header 'X-API-Key: <api-key>'
{
  "elements": [
    {
      "id": "<string>",
      "linkedinUrl": "<string>",
      "title": "<string>",
      "postedDate": "2023-11-07T05:31:56Z",
      "companyName": "<string>",
      "companyLink": "<string>",
      "companyUniversalName": "<string>",
      "location": {
        "linkedinText": "<string>"
      },
      "easyApply": true
    }
  ],
  "pagination": {
    "totalPages": 123,
    "totalElements": 123,
    "pageNumber": 123,
    "previousElements": 123,
    "pageSize": 123,
    "paginationToken": "<string>"
  },
  "status": "<string>",
  "error": "<string>",
  "query": {
    "title": "<string>",
    "companyId": "<string>",
    "location": "<string>",
    "geoId": "<string>",
    "sortBy": "<string>",
    "workplaceType": "<string>",
    "postedLimit": "<string>",
    "page": 123
  }
}
const params = new URLSearchParams({
  search: 'Software Engineer',
  companyId: '1441', // Google
  location: 'US',
  sortBy: 'date',
  workplaceType: 'hybrid,remote',
  employmentType: 'full-time',
  postedLimit: 'month',
  page: '1',
  salary: '100k+',
});
fetch(`https://api.harvest-api.com/linkedin/job-search?${params.toString()}`, {
  headers: { 'X-API-Key': '<api-key>' },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

​
How to get Company ID

​
By company URL or ID

const params = new URLSearchParams({
  query: 'https://www.linkedin.com/company/google',
  // query: 'google', // 'google' is also accepted as a company ID (last part of the URL)
  apiKey: '<api-key>',
});

fetch(`https://api.harvest-api.com/linkedin/company?${params.toString()}`)
  .then((res) => res.json())
  .then((data) => {
    const company = data.element;
    console.log(`LinkedIn ID for Google: ${company?.id}`);
  });

​
By searching for a company name

const params = new URLSearchParams({
  search: 'Google',
  apiKey: '<api-key>',
});

fetch(`https://api.harvest-api.com/linkedin/company-search?${params.toString()}`)
  .then((res) => res.json())
  .then((data) => {
    const companies = data.elements;
    const firstMatchId = companies[0].id;
    console.log(`LinkedIn ID for Google: ${firstMatchId}`);
  });

​
Search by LinkedIn GeoID

For most of the cases, when specifying full location name, the search by the location parameter works fine.
However sometimes search by location may not give you what you expect, as LinkedIn have some other suggested location for your text query. For example, NY returns New Zealand instead of New York; UK returns Ukraine instead of United Kingdom. The location search is based on LinkedIn autocomplete feature, you can try it on the website first. The scraper will use the first suggestion from the autocomplete popup when you type your location. The same autocomplete is available via our API. You can look up a location and get LinkedIn GeoID to use for the API endpoint. 
const apiKey = '<api-key>';

fetch(`https://api.harvest-api.com/linkedin/geo-id-search?search=New York`, {
  headers: { 'X-API-Key': apiKey },
})
  .then((response) => response.json())
  .then((data) => {
    console.log('All matches:', data.elements);
    console.log('Closest match GeoID:', data.entityId);

    // Search for profiles in New York
    const params = new URLSearchParams({
      geoId: data.entityId,
      apiKey,
    });
    fetch(`https://api.harvest-api.com/linkedin/profile-search?${params.toString()}`)
      .then((response) => response.json())
      .then((data) => console.log(data));
  });

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
search
string

Search jobs by title

​
companyId
string

Filter by company ID. One value or multiple comma-separated.

​
location
string

Filter by location text

​
geoId
string

Filter by location as LinkedIn Geo ID. Overrides the location query param. Use the /linkedin/geo-id-search endpoint to find the Geo ID

​
sortBy
string

Sort by field. Supported values: 'relevance', 'date'

​
workplaceType
string

Filter by workplace type. One or multiple values comma-separated. Supported values: 'office', 'hybrid', 'remote'

​
employmentType
string

Filter by employment type. One or multiple values comma-separated. Supported values: 'full-time', 'part-time', 'contract', 'temporary', 'internship'

​
salary
string

Filter by salary range. Supported values: '40k+', '60k+', '80k+', '100k+', '120k+', '140k+', '160k+', '180k+', '200k+'

​
postedLimit
string

Filter posts by maximum posted date. Supported values: '24h', 'week', 'month'

​
experienceLevel
string

Filter by experience level. One or multiple values comma-separated. Supported values: 'internship', 'entry', 'associate', 'mid-senior', 'director', 'executive'

​
industryId
string

Filter by industry ID. One value or multiple comma-separated industry IDs. Full list of IDs: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng.csv

​
functionId
string

Filter by job function ID. One value or multiple comma-separated function IDs. Full list of IDs: https://github.com/HarvestAPI/apify-linkedin-profile-search/blob/main/.actor/input_schema.json#L142

​
under10Applicants
string

Include this parameter to filter jobs with under 10 applicants

​
easyApply
string

Set this parameter to 'true' filter jobs with Easy Apply option or 'false' to exclude. Values can be 'true' or 'false'

​
page
integer
default:1

Page number for pagination

Response

Job search response

​
elements
object[]
​
pagination
object
​
status
string
​
error
string
​
query
object