# Linkedin Jobs Scraper - Openclaw, MCP native (`openclaw/linkedin-jobs-scraper`) Actor
Scrape LinkedIn jobs into agent-ready JSON (full job description + rich company details). Built for OpenClaw workflows and MCP-native tool calling.
- **URL**: https://apify.com/openclaw/linkedin-jobs-scraper.md
- **Developed by:** [John Smith](https://apify.com/openclaw) (community)
- **Categories:** Agents, Jobs, Automation
- **Stats:** 122 total users, 10 monthly users, 99.7% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $0.00005 / actor start
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## LinkedIn Jobs Scraper - PPR
Scrape jobs from LinkedIn jobs search results along with company details. Get key information to find contact info.
This tool scrapes jobs from the public version of LinkedIn jobs search which **does not require cookies or login**.
### Getting Started
1. Go to [LinkedIn jobs search page](https://www.linkedin.com/jobs/search/)
2. Search with your required filters
3. Once done, copy the full URL from the address bar
4. Paste the URL into this actor's **Start URLs** input field
Alternatively, provide **Search Keywords** and **Search Location** directly.
### Features
- **No cookies or login required** — scrapes publicly accessible data only
- **Company details** — description, website, employee count, industry, specialties
- **Job poster info** — recruiter name, title, photo, profile URL
- **Full job descriptions** — HTML and plain text
- **Salary info** — when available from LinkedIn
- **Split search by location** — overcome LinkedIn's ~1000 results limit per search by auto-splitting into city-level searches
- **Deduplication** — automatically ignores duplicate jobs across searches
- **PPR pricing** — pay per result model
### Related Scrapers
- [Indeed jobs scraper](https://apify.com/curious_coder/indeed-scraper) — extract jobs data from Indeed
- [Apollo leads scraper](https://apify.com/curious_coder/apollo-io-scraper) — find email addresses for companies
### Overcoming LinkedIn's 1000 Job Limit
LinkedIn limits the number of jobs per search to ~1000 even though total matching jobs are far more. To overcome this:
1. Enable **"Split search URLs by location"**
2. Select a **Target Country**
3. The scraper will generate multiple search URLs targeting different cities in that country
4. Duplicate jobs are automatically ignored
### Sample Output Data
```json
{
"id": "3692563200",
"link": "https://www.linkedin.com/jobs/view/3692563200",
"title": "English Data Labeling Analyst",
"companyName": "Facebook",
"companyLinkedinUrl": "https://www.linkedin.com/company/facebook",
"companyLogo": "https://media.licdn.com/dms/image/...",
"location": "Los Angeles Metropolitan Area",
"salaryInfo": ["$17.00", "$19.00"],
"postedAt": "2025-08-16",
"benefits": ["Actively Hiring"],
"descriptionHtml": "APPROVED REMOTE LOCATIONS: ...
",
"descriptionText": "APPROVED REMOTE LOCATIONS: ...",
"applicantsCount": "200",
"applyUrl": "",
"jobPosterName": "Andrea Cowan",
"jobPosterTitle": "Technical Recruiter at Meta",
"jobPosterPhoto": "https://media.licdn.com/dms/image/...",
"jobPosterProfileUrl": "https://ca.linkedin.com/in/andrea-cowan-458b5423b",
"seniorityLevel": "Associate",
"employmentType": "Contract",
"jobFunction": "Other",
"industries": "Retail Office Equipment",
"companyDescription": "The Facebook company is now Meta...",
"companyWebsite": "https://www.meta.com",
"companyEmployeesCount": 36275,
"companyIndustry": "Technology, Information and Internet",
"companySpecialties": null,
"companyType": "Public Company",
"companyFounded": "2004",
"companyHeadquarters": "Menlo Park, CA"
}
````
### Output Fields
| Field | Description |
|---|---|
| `id` | Unique LinkedIn job posting ID |
| `link` | Direct URL to job listing |
| `title` | Job title |
| `companyName` | Hiring company name |
| `companyLinkedinUrl` | Company's LinkedIn page |
| `companyLogo` | Company logo URL |
| `location` | Job location |
| `salaryInfo` | Salary range (array) |
| `postedAt` | Date posted |
| `benefits` | Job benefits/badges |
| `descriptionHtml` | Full description in HTML |
| `descriptionText` | Full description in plain text |
| `applicantsCount` | Number of applicants |
| `applyUrl` | External application URL |
| `jobPosterName` | Recruiter/poster name |
| `jobPosterTitle` | Recruiter/poster title |
| `jobPosterPhoto` | Recruiter/poster photo URL |
| `jobPosterProfileUrl` | Recruiter/poster LinkedIn profile |
| `seniorityLevel` | Seniority level |
| `employmentType` | Employment type |
| `jobFunction` | Job function |
| `industries` | Industry |
| `companyDescription` | Full company description |
| `companyWebsite` | Company website URL |
| `companyEmployeesCount` | Number of employees |
| `companyIndustry` | Company industry |
| `companySpecialties` | Company specialties |
| `companyType` | Company type (Public, Private, etc.) |
| `companyFounded` | Year founded |
| `companyHeadquarters` | HQ location |
### Programmatic Usage
#### Python
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_API_TOKEN")
run_input = {
"startUrls": [
{"url": "https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States"}
],
"maxItems": 500,
"scrapeCompany": True,
"scrapeJobDetails": True,
}
run = client.actor("YOUR_USERNAME/linkedin-jobs-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(f"{item['title']} at {item['companyName']} - {item['location']}")
```
#### Node.js
```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('YOUR_USERNAME/linkedin-jobs-scraper').call({
startUrls: [
{ url: 'https://www.linkedin.com/jobs/search/?keywords=data+scientist&location=United+States' }
],
maxItems: 500,
scrapeCompany: true,
scrapeJobDetails: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => console.log(`${item.title} at ${item.companyName}`));
```
### Integrations
You can use **Make** or **Zapier** to integrate this scraper with any other SaaS platform by designing your own automation flows.
The actor stores results in a dataset. You can export data in various formats such as CSV, JSON, XLS, etc. You can scrape and access data on demand using the API.
### Support
If you've got any technical feedback or found a bug, please create an issue on the actor's Issues tab in Apify Console.
# Actor input Schema
## `startUrls` (type: `array`):
Go to LinkedIn jobs search page (https://www.linkedin.com/jobs/search/), apply your filters, copy the full URL from the address bar and paste here. You can add multiple URLs.
## `searchKeywords` (type: `array`):
Alternative to Start URLs: provide keywords to search (e.g., 'software engineer', 'data scientist'). Will be used only if no Start URLs are provided.
## `searchLocation` (type: `string`):
Location for keyword search (e.g., 'United States', 'London'). Used with Search Keywords.
## `maxItems` (type: `integer`):
Maximum number of job listings to scrape. LinkedIn limits search results to ~1000 per query. Use 'Split search by location' to get more.
## `scrapeCompany` (type: `boolean`):
Scrape additional company information (description, website, employee count). This makes the scraper slower but provides richer data.
## `scrapeJobDetails` (type: `boolean`):
Fetch full job description, poster info, and application details for each listing. Disabling this only returns card-level data but is much faster.
## `splitSearchByLocation` (type: `boolean`):
LinkedIn limits results to ~1000 jobs per search. Enable this to automatically split your search into multiple city-level searches within the target country to get more results. Ignores duplicate jobs automatically.
## `targetCountry` (type: `string`):
Country to split searches by city. Required when 'Split search by location' is enabled.
## `datePosted` (type: `string`):
On LinkedIn jobs search page, select the Date filter and copy the search URL. Or use this to override.
## `proxy` (type: `object`):
Proxy settings. Residential proxies recommended for best results.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States"
}
],
"maxItems": 200,
"scrapeCompany": true,
"scrapeJobDetails": true,
"splitSearchByLocation": false,
"targetCountry": "",
"datePosted": "",
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States"
}
],
"maxItems": 200,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("openclaw/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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"startUrls": [{ "url": "https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States" }],
"maxItems": 200,
"proxy": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("openclaw/linkedin-jobs-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"startUrls": [
{
"url": "https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States"
}
],
"maxItems": 200,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call openclaw/linkedin-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=openclaw/linkedin-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Linkedin Jobs Scraper - Openclaw, MCP native",
"description": "Scrape LinkedIn jobs into agent-ready JSON (full job description + rich company details). Built for OpenClaw workflows and MCP-native tool calling.",
"version": "0.0",
"x-build-id": "HMm3H0CeNNbidQGbQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openclaw~linkedin-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openclaw-linkedin-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/openclaw~linkedin-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-openclaw-linkedin-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/openclaw~linkedin-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-openclaw-linkedin-jobs-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"startUrls": {
"title": "LinkedIn Search URLs",
"type": "array",
"description": "Go to LinkedIn jobs search page (https://www.linkedin.com/jobs/search/), apply your filters, copy the full URL from the address bar and paste here. You can add multiple URLs.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"searchKeywords": {
"title": "Search Keywords (Alternative)",
"type": "array",
"description": "Alternative to Start URLs: provide keywords to search (e.g., 'software engineer', 'data scientist'). Will be used only if no Start URLs are provided.",
"items": {
"type": "string"
}
},
"searchLocation": {
"title": "Search Location (Alternative)",
"type": "string",
"description": "Location for keyword search (e.g., 'United States', 'London'). Used with Search Keywords."
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of job listings to scrape. LinkedIn limits search results to ~1000 per query. Use 'Split search by location' to get more.",
"default": 200
},
"scrapeCompany": {
"title": "Scrape Company Details",
"type": "boolean",
"description": "Scrape additional company information (description, website, employee count). This makes the scraper slower but provides richer data.",
"default": true
},
"scrapeJobDetails": {
"title": "Scrape Full Job Details",
"type": "boolean",
"description": "Fetch full job description, poster info, and application details for each listing. Disabling this only returns card-level data but is much faster.",
"default": true
},
"splitSearchByLocation": {
"title": "Split Search URLs by Location",
"type": "boolean",
"description": "LinkedIn limits results to ~1000 jobs per search. Enable this to automatically split your search into multiple city-level searches within the target country to get more results. Ignores duplicate jobs automatically.",
"default": false
},
"targetCountry": {
"title": "Target Country (for Split Search)",
"enum": [
"",
"usa",
"uk",
"canada",
"india",
"germany",
"france",
"australia",
"netherlands",
"spain",
"italy",
"brazil",
"singapore",
"japan",
"uae"
],
"type": "string",
"description": "Country to split searches by city. Required when 'Split search by location' is enabled.",
"default": ""
},
"datePosted": {
"title": "Date Posted Filter",
"enum": [
"",
"r86400",
"r604800",
"r2592000"
],
"type": "string",
"description": "On LinkedIn jobs search page, select the Date filter and copy the search URL. Or use this to override.",
"default": ""
},
"proxy": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. Residential proxies recommended for best results."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```