linkedin-jobs-api

You can install the linkedin-jobs-api package using either npm or yarn.

npm i linkedin-jobs-api

# or

yarn add linkedin-jobs-api

To search for jobs, import the package and call linkedIn.query(queryOptions). This method returns a Promise that resolves to an array of Job objects.

const linkedIn = require('linkedin-jobs-api');

const queryOptions = {
  keyword: 'software engineer',
  location: 'India',
  dateSincePosted: 'past Week',
  jobType: 'full time',
  remoteFilter: 'remote',
  salary: '100000',
  experienceLevel: 'entry level',
  limit: '10',
  page: "0",
  has_verification: false,
  under_10_applicants: false,
};

linkedIn.query(queryOptions).then(response => {
	console.log(response); // An array of Job objects
});

The primary way to use this API is by calling the query() method. You pass a queryObject containing your search criteria, and the function returns a Promise that resolves to an array of job objects. The API handles pagination, rate limiting (with exponential backoff), and internal caching automatically.

const { query } = require('linkedin-jobs-api');

const jobs = await query({
  keyword: 'Software Engineer',
  location: 'New York',
  limit: 10,
  remoteFilter: 'remote'
});

console.log(jobs);

The API uses an internal JobCache with a 1-hour TTL (Time To Live) to prevent redundant network requests for the same query. You can interact with the cache using the following exported utilities:

• clearCache(): Clears all currently cached job results.
• getCacheSize(): Returns the number of items currently in the cache.
• JobCache: The class definition used for the internal cache.

const { clearCache, getCacheSize } = require('linkedin-jobs-api');

console.log(getCacheSize());
clearCache();

Each job returned by the query() method follows this schema:

{
  "position": "Job Title",
  "company": "Company Name",
  "location": "City, State/Country",
  "date": "ISO Date String",
  "salary": "Salary info or 'Not specified'",
  "jobUrl": "URL to the job posting",
  "companyLogo": "URL to the company logo",
  "agoTime": "Relative time string (e.g., '2 days ago')"
}