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

Scrapes LinkedIn job postings by search query and location. Returns each job as a flat row with title, company, location, link, and optional full description, salary, skills, and raw HTML.

- **URL**: https://apify.com/parseforge/linkedin-jobs-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Developer tools, Other
- **Stats:** 53 total users, 2 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.70 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### LinkedIn Jobs Scraper

**Scrape LinkedIn job postings by title, location, and filters, up to a million per run.** Every job comes with its description, salary, skills, company details, and raw HTML. No login, no cookies, no API key. Export to CSV, JSON, Excel, or XML.

LinkedIn's official API requires partner approval, OAuth tokens, and strict rate limits. This scraper reads the public job search pages directly, filtering by date posted, job type, experience level, workplace type, Easy Apply, and minimum salary. It returns each match in one consistent schema, with optional full job descriptions and extracted skills.

| Who uses it | What they scrape LinkedIn for |
|---|---|
| Recruiters | Monitor competitor hiring volumes and job descriptions for specific roles. |
| Job boards | Aggregate listings from LinkedIn into a centralized search index. |
| Market analysts | Track which skills and experience levels are in demand by region. |
| Sales teams | Find companies that are hiring to identify new business opportunities. |

### What it does

This Actor collects LinkedIn job postings from a search query and location, and returns each one as a flat row with title, company, location, link, and optional full description, salary, skills, and raw HTML.

- 🔍 **Search by title and location:** Enter a job title, keyword, or company name and a city, state, country, or 'Remote'.
- 📅 **Date filters:** Limit results to jobs posted in the past 24 hours, past week, or past month.
- 💼 **Job type and experience:** Filter by full-time, part-time, contract, internship, and more, plus entry level through executive.
- 🏠 **Workplace type:** Narrow to on-site, remote, or hybrid roles only.
- ✅ **Easy Apply only:** Return only jobs that accept LinkedIn Easy Apply applications.
- 💰 **Minimum salary:** Set a USD salary floor at $40k, $60k, $80k, $100k, $120k, $140k, $160k, $180k, or $200k+.
- 📄 **Full job details:** Fetch complete descriptions, company info, and salary data, or disable for 5-10x faster basic-only runs.
- 🛠️ **Skill extraction:** Parse and return a list of skills mentioned in each job description.
- 📜 **Raw HTML:** Include the raw HTML of each job detail page for custom downstream parsing.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with LinkedIn data

**📊 Monitor hiring trends.**

A market analyst runs the scraper weekly for 'data engineer' in 'United States' to track demand shifts and salary floors by region.

**🎯 Build a niche job board.**

A job board operator aggregates remote software roles by running daily scrapes for multiple tech titles with the 'Remote' workplace filter.

**📈 Prospect companies that are growing.**

A sales team scrapes 'sales manager' in their target cities to identify companies with active hiring and reach out with a relevant pitch.

**🧠 Analyze skill requirements.**

An HR analyst extracts skills from 'product manager' postings across several regions to update internal competency models.

### Why choose this scraper

|  | What you get |
|---|---|
| **No login or cookies** | Scrapes public LinkedIn job pages without authentication, so you never risk an account block. |
| **Full detail mode** | Optionally fetches the complete job description, company details, salary, and skills from each listing. |
| **Fast basic mode** | Disable full details to collect title, company, location, and link 5-10x faster. |
| **Rich filters** | Narrow by date posted, job type, experience level, workplace type, Easy Apply, and minimum salary. |

### How it compares

This Actor offers full job detail scraping, skill extraction, and raw HTML output alongside the core search, while the alternative focuses on search results with company details.

| Feature | ParseForge | Linkedin Jobs Search |
|---|---|---|
| Full job description scraping | Yes, optional | Not listed |
| Skill extraction from descriptions | Yes, optional | Not listed |
| Raw HTML output | Yes, optional | Not listed |
| Easy Apply filter | Yes | Not listed |
| Minimum salary filter | Yes | Not listed |
| Workplace type filter (remote, hybrid, on-site) | Yes | Not listed |

### Configure the run

Drive the Actor from a search query and location, and filters run as each job is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "searchQuery": "software engineer",
  "location": "United States",
  "maxItems": 10,
  "scrapeJobDetails": true,
  "extractSkills": true,
  "includeBlockedJobs": false,
  "includeRawHtml": false,
  "maxConcurrency": 10
}
```

A larger pull:

```json
{
  "searchQuery": "software engineer",
  "location": "United States",
  "maxItems": 200,
  "scrapeJobDetails": true,
  "extractSkills": true,
  "includeBlockedJobs": false,
  "includeRawHtml": false,
  "maxConcurrency": 10
}
```

### Pricing

Pay-per-result: **$0.399 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $39.90 |
| 1,000 results | $399.00 |
| 10,000 results | $3,990.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [LinkedIn Jobs Scraper](https://apify.com/parseforge/linkedin-jobs-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to LinkedIn through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/linkedin-jobs-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your search query and location combination returns results on LinkedIn.com. Try broadening the location or removing restrictive filters like Easy Apply or a high minimum salary.

**Why are some jobs missing full details?**

Some LinkedIn job postings block detail access. Enable 'Include Blocked Jobs' to still receive basic info for those listings with an isBlocked=true flag.

**The scraper is running slowly. How can I speed it up?**

Disable 'Scrape Full Job Details' to switch to basic mode, which is 5-10x faster. You can also increase max concurrency, though this may raise the chance of blocks.

**I'm getting blocked or seeing empty results after many runs.**

Reduce the max concurrency setting to a lower number, such as 5, to make requests less aggressive and avoid triggering LinkedIn's rate limits.

### FAQ

| Question | Answer |
|---|---|
| Do I need a LinkedIn account or API key to use this? | No. The scraper reads public LinkedIn job search pages and requires no login, cookies, or API credentials. |
| Can I scrape jobs from a specific company? | Yes. Enter the company name in the search query field, and optionally add a location to narrow results to that company's postings. |
| How many jobs can I collect in one run? | You can set the maximum up to 1,000,000 jobs. The actual number returned depends on how many match your search and filters. |
| What is the difference between basic and full detail mode? | Basic mode returns title, company, location, and link and runs 5-10x faster. Full detail mode also fetches the job description, salary, skills, and company details. |
| Can I filter by remote jobs only? | Yes. Set the workplace type filter to 'Remote' to return only jobs listed as remote. |
| Does this scraper handle LinkedIn's anti-scraping measures? | The Actor runs on Apify's infrastructure with rotating proxies and configurable concurrency. Lower the max concurrency if you encounter blocks. |
| Can I get the raw HTML of each job page? | Yes. Enable the 'Include Raw HTML' option to receive the full HTML of each job detail page in your output for custom parsing. |
| How do I extract skills from job descriptions? | Enable the 'Extract Skills' option. The scraper will parse the job description and return a list of skills mentioned. |
| What export formats are supported? | You can export your dataset to CSV, JSON, Excel, or XML from the Apify platform. |
| Can I schedule this scraper to run daily? | Yes. Use Apify's scheduler to run the Actor at any interval, such as hourly or daily, to track new postings over time. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by LinkedIn Corporation. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `searchQuery` (type: `string`):

Job title, keywords, or company name to search for

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

City, state, country, or 'Remote'

## `maxItems` (type: `integer`):

How many jobs to collect per run.

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

Filter jobs by when they were posted

## `jobType` (type: `array`):

Filter by employment type

## `experienceLevel` (type: `array`):

Filter by required experience

## `workplaceType` (type: `array`):

Filter by workplace arrangement

## `easyApplyOnly` (type: `boolean`):

Only return jobs with LinkedIn Easy Apply

## `salary` (type: `string`):

Filter by minimum salary (USD)

## `sortBy` (type: `string`):

How to sort job results

## `scrapeJobDetails` (type: `boolean`):

Fetch complete job descriptions, skills, salary info, and company details. Disabling this returns only basic info (title, company, location, link) but is 5-10x faster.

## `extractSkills` (type: `boolean`):

Parse skills from job descriptions

## `includeBlockedJobs` (type: `boolean`):

Include jobs where full details could not be retrieved. Returns basic info with isBlocked=true flag.

## `includeRawHtml` (type: `boolean`):

Include the raw HTML of the job detail page in the output for custom parsing.

## `maxConcurrency` (type: `integer`):

Maximum number of parallel requests. Lower if you experience blocks.

## Actor input object example

```json
{
  "searchQuery": "software engineer",
  "location": "United States",
  "maxItems": 10,
  "datePosted": "anyTime",
  "jobType": [],
  "experienceLevel": [],
  "workplaceType": [],
  "easyApplyOnly": false,
  "sortBy": "relevant",
  "scrapeJobDetails": true,
  "extractSkills": true,
  "maxConcurrency": 10
}
```

# Actor output Schema

## `jobs` (type: `string`):

Complete dataset with all scraped job listings including full details

## `overview` (type: `string`):

Summary view with key job fields in a table format

# 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 = {
    "searchQuery": "software engineer",
    "location": "United States",
    "maxItems": 10,
    "scrapeJobDetails": true,
    "extractSkills": true,
    "includeBlockedJobs": false,
    "includeRawHtml": false,
    "maxConcurrency": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/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 = {
    "searchQuery": "software engineer",
    "location": "United States",
    "maxItems": 10,
    "scrapeJobDetails": True,
    "extractSkills": True,
    "includeBlockedJobs": False,
    "includeRawHtml": False,
    "maxConcurrency": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/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 '{
  "searchQuery": "software engineer",
  "location": "United States",
  "maxItems": 10,
  "scrapeJobDetails": true,
  "extractSkills": true,
  "includeBlockedJobs": false,
  "includeRawHtml": false,
  "maxConcurrency": 10
}' |
apify call parseforge/linkedin-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/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/0lLu3ht7kPSG6K7qi/builds/pJQNJQa4ZI3KQnxa0/openapi.json
