# 🏆 LinkedIn Jobs Scraper (`valig/linkedin-jobs-scraper`) Actor

$0.4/1K jobs | Scrape LinkedIn job listings based on your selected role and location, saving you time and effort.

- **URL**: https://apify.com/valig/linkedin-jobs-scraper.md
- **Developed by:** [Vali G](https://apify.com/valig) (community)
- **Categories:** Jobs, Automation
- **Features:** Limited permissions
- **Stats:** 41,824 total users, 8,974 monthly users, 100.0% runs succeeded, 161 bookmarks
- **User rating**: 4.73 out of 5 stars

## Pricing

from $0.28 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![](https://pub-f6a65c213d4f49948940882ac7589d61.r2.dev/apify/linkedin-jobs-scraper/banner.jpg)

Extract comprehensive job postings from LinkedIn with ease. This Apify actor allows you to search and scrape detailed job data including salaries, descriptions, recruiter details, and company information using advanced filtering options.

***

### 🌟 Features

- **Granular Filtering:** Search by job title, specific companies, location, remote work options, contract type, and experience level.
- **Time-Specific Searches:** Filter job postings by the date they were posted (e.g., past 24 hours, past week, past month).
- **Rich Data Extraction:** Get full job descriptions in both plain text and HTML, along with salary ranges, applicant counts, and direct application URLs.
- **Advanced URL Parameters:** Support for passing custom URL parameters to fine-tune your search requests directly.
- **Deduplication:** Skip specific job IDs to avoid scraping postings you've already processed.

***

### 📥 Input Configuration

The actor accepts the following input parameters to customize your scraping job:

| Field | Type | Default | Description | Example |
| --- | --- | --- | --- | --- |
| **`keywords`** | `string` | - | Search by job title, skill, or company. | `"Java"` |
| **`location`** | `string` | - | Target a specific city, state, or zip code. | `"New York"` |
| **`datePosted`** | `string` | - | Filter by age of the posting (`r2592000` = Past month, `r604800` = Past week, `r86400` = Past 24 hours). | `"r604800"` |
| **`companyName`** | `array` | - | Filter by one or more company names. | `["Google", "Apple"]` |
| **`companyId`** | `array` | - | Filter by specific LinkedIn company IDs. | `["1441", "162479"]` |
| **`easyApply`** | `boolean` | - | Only include jobs with the Easy Apply option. | `true` |
| **`under10Applicants`** | `boolean` | - | Only include jobs with Under 10 applicants. | `true` |
| **`limit`** | `integer` | `100` | Maximum number of results to scrape (Max `1000`). | `100` |
| **`urlParam`** | `array` | - | Pass additional advanced URL parameters as Key/Value pairs. | `[{"key": "f_TPR", "value": "r3600"}]` |
| **`skipJobId`** | `array` | - | Provide an array of specific Job IDs to exclude from results. | `["4219847745"]` |
| **`titleInclude`** | `array` | - | Only include jobs whose title contains at least one of these values (case insensitive). | `["Software Developer", "Software Engineer"]` |
| **`titleExclude`** | `array` | - | Exclude jobs whose title contains at least one of these values (case insensitive). | `["Head of Product", " Manager "]` |

***

### 📤 Output Example

The actor stores its results in the default dataset. Each item represents a single job posting with deeply extracted details.

```json
{
	"id": "4219847745",
	"url": "https://www.linkedin.com/jobs/view/c%2B%2B-software-engineer-at-goliath-partners-4219847745",
	"title": "C++ Software Engineer",
	"location": "New York, NY",
	"companyName": "Goliath Partners",
	"companyUrl": "https://www.linkedin.com/company/goliath-partners-inc",
	"recruiterName": "Ishan Ghosh",
	"recruiterUrl": "https://www.linkedin.com/in/ishan-ghosh-033773213",
	"experienceLevel": "Mid-Senior level",
	"contractType": "Full-time",
	"workType": "Engineering, Finance, and Research",
	"sector": "Financial Services, Software Development, and Market Research",
	"salary": "$250,000.00/yr - $800,000.00/yr",
	"applyType": "EASY_APPLY",
	"postedTimeAgo": "1 day ago",
	"postedDate": "2025-04-30",
	"applicationsCount": "64 applicants",
	"description": "We are working with an expanding high-frequency trading firm based out of New York City who is looking for a qualified Software Engineer with C++ experience to join their team. They are coming off a very successful year and are anticipating that success to continue into the coming years. They are offering hybrid work opportunities and are willing to wait all non competes up to two years.Role:Developing low latency and exchange gateway connectivityScale and optimize trading systemsCollaborating with quant research and trading teams to enhance profitabilityEssential Skills:Bachelors in Computer Science/ Statistics/ Mathematics etc.Experience with C/C++Familiarity with distributed systems and infrastructure developmentPrevious examples of competitive edge (high placed hackathon, awards, academic excellence, etc.)Beneficial Skills:Masters/PhD in STEM related subjectsKnowledge of PythonWork experience with a disruptor, startup, or trading enterpriseComp:Base salary $250-300k with additional bonus packages which can bring total comp up to $850k.If interested, please apply and Goliath Partners will be in touch!",
	"descriptionHtml": "<p>We are working with an expanding high-frequency trading firm based out of New York City who is looking for a qualified Software Engineer with C++ experience to join their team. They are coming off a very successful year and are anticipating that success to continue into the coming years. They are offering hybrid work opportunities and are willing to wait all non competes up to two years.</p><p><br></p><p>Role:</p><p>Developing low latency and exchange gateway connectivity</p><p>Scale and optimize trading systems</p><p>Collaborating with quant research and trading teams to enhance profitability</p><p><br></p><p>Essential Skills:</p><p>Bachelors in Computer Science/ Statistics/ Mathematics etc.</p><p>Experience with C/C++</p><p>Familiarity with distributed systems and infrastructure development</p><p>Previous examples of competitive edge (high placed hackathon, awards, academic excellence, etc.)</p><p><br></p><p>Beneficial Skills:</p><p>Masters/PhD in STEM related subjects</p><p>Knowledge of Python</p><p>Work experience with a disruptor, startup, or trading enterprise</p><p><br></p><p>Comp:</p><p>Base salary &#x24;250-300k with additional bonus packages which can bring total comp up to &#x24;850k.</p><p><br></p><p>If interested, please apply and Goliath Partners will be in touch!</p>"
}
```

***

### 💡 Use Cases

- **Market Research:** Analyze salary trends, remote work adoption, and in-demand skills within specific industries.
- **Recruitment & Talent Acquisition:** Track competitor job postings and hiring strategies.
- **Job Boards & Aggregators:** Populate your own job platforms with fresh, highly relevant listings.
- **Lead Generation:** Identify companies that are actively expanding their teams to offer relevant B2B services.

# Actor input Schema

## `keywords` (type: `string`):

Search by title, skill, or company

## `location` (type: `string`):

City, state, or zip code

## `datePosted` (type: `string`):

Filter by age of the job posting

## `companyName` (type: `array`):

Filter by company name

## `companyId` (type: `array`):

Filter by company ID

## `easyApply` (type: `boolean`):

Only include jobs with the Easy Apply option

## `under10Applicants` (type: `boolean`):

Only include jobs with Under 10 applicants

## `limit` (type: `integer`):

Maximum results count

## `urlPath` (type: `string`):

Custom job search path. Must start with /jobs/ (e.g., /jobs/search).

## `urlParam` (type: `array`):

Pass additional URL parameters to the search request

## `skipJobId` (type: `array`):

Filter out specific job IDs from results

## `titleInclude` (type: `array`):

Only include jobs whose title contains all words from at least one of these phrases (case insensitive, word order does not matter).

## `titleExclude` (type: `array`):

Exclude jobs whose title contains all words from at least one of these phrases (case insensitive, word order does not matter).

## Actor input object example

```json
{
  "keywords": "Software Developer",
  "location": "New York",
  "datePosted": "r604800",
  "companyName": [
    "Google",
    "Apple"
  ],
  "companyId": [
    "1441",
    "162479"
  ],
  "easyApply": true,
  "under10Applicants": true,
  "limit": 100,
  "urlPath": "/jobs/search",
  "urlParam": [
    {
      "key": "f_TPR",
      "value": "r3600"
    }
  ],
  "skipJobId": [
    "4219847745",
    "4219847746"
  ],
  "titleInclude": [
    "Software Developer",
    "Software Engineer",
    "React Developer"
  ],
  "titleExclude": [
    "Junior Developer",
    "Manager"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("valig/linkedin-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("valig/linkedin-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call valig/linkedin-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,valig/linkedin-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RIGGeqD6RqKmlVoQU/builds/2AkLFFgw3Id03ZRI7/openapi.json
