Open LinkedIn Jobs

A powerful, type-safe Node.js package for fetching job listings from LinkedIn's public API.

Features

🚀 Clean Architecture: Built with separation of concerns (Entities, Use Cases, Adapters).
💪 TypeScript Support: Written in TypeScript with full type definitions included.
🛡️ Robust & Secure:
- Automatic User-Agent rotation using generic modern user agents.
- Intelligent rate-limiting handling and retry logic.
- Input sanitization.
⚡ Efficient: Uses cheerio for fast HTML parsing and keep-alive HTTP connections.
📦 Zero Configuration: Works out of the box with sensible defaults.

Installation

npm install open-linkedin-jobs

Usage

TypeScript (Recommended)

import { linkedInJobSearch, QueryOptions, Job } from 'open-linkedin-jobs';

const queryOptions: QueryOptions = {
  keyword: 'Software Engineer',
  location: 'United States',
  dateSincePosted: 'past week',
  jobType: 'full time',
  remoteFilter: 'remote',
  salary: '100000',
  experienceLevel: 'entry level',
  limit: 10
};

linkedInJobSearch(queryOptions).then((jobs: Job[]) => {
  jobs.forEach(job => {
    console.log(`Title: ${job.title}`);
    console.log(`Company: ${job.company}`);
    console.log(`Location: ${job.location}`);
    console.log(`URL: ${job.url}`);
    console.log('---');
  });
});

JavaScript (ES Modules)

import { linkedInJobSearch } from 'open-linkedin-jobs';

const jobs = await linkedInJobSearch({
  keyword: 'Product Manager',
  location: 'London, UK',
  limit: 5
});

console.log(jobs);

Configuration

The linkedInJobSearch(options) function accepts a QueryOptions object:

Option	Type	Description	Example
`keyword`	`string`	Job title or keyword	`'Software Engineer'`
`location`	`string`	Location to search	`'United States'`
`dateSincePosted`	`string`	`'past month'`, `'past week'`, `'24hr'`	`'past week'`
`jobType`	`string`	`'full time'`, `'part time'`, `'contract'`, `'temporary'`, `'volunteer'`, `'internship'`	`'full time'`
`remoteFilter`	`string`	`'on-site'`, `'remote'`, `'hybrid'`	`'remote'`
`salary`	`string`	Annual salary expectation	`'100000'`
`experienceLevel`	`string`	`'internship'`, `'entry level'`, `'associate'`, `'senior'`, `'director'`, `'executive'`	`'senior'`
`limit`	`number`	Number of jobs to fetch	`10`
`sortBy`	`string`	`'recent'` or `'relevant'`	`'recent'`

Return Type

Returns a Promise resolving to an array of Job objects:

interface Job {
  title: string;
  company: string;
  location: string;
  postedDate: string;
  salary: string;
  url: string;
  companyLogoUrl: string;
  postedTimeAgo: string;
}

Disclaimer & Legal

This package is intended for educational and research purposes only.

This tool scrapes data from LinkedIn's public guest pages.
Standard scraping caveats apply. LinkedIn may block your IP if you make too many requests too quickly.
By using this tool, you agree to comply with LinkedIn's Terms of Service.
The author (Hanish Rao) is not responsible for any misuse of this tool or any consequences resulting from its use.

License

GNU Affero General Public License v3.0 (AGPL-3.0)

Hyraze/open-linkedin-jobs