# LinkedIn Jobs Scraper API (`orgupdate/linkedin-jobs-scraper-api`) Actor

The most advanced enterprise-grade LinkedIn job scraper API. This Indeed job scraper API extracts real-time job postings at scale from any active Indeed Jobs search results worldwide.

- **URL**: https://apify.com/orgupdate/linkedin-jobs-scraper-api.md
- **Developed by:** [Orgupdate](https://apify.com/orgupdate) (community)
- **Categories:** Developer tools, Jobs, Lead generation
- **Stats:** 7 total users, 0 monthly users, 93.5% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$28.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## 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

The most efficient way to extract job listings directly from Linkedin Jobs search results.

[View on Apify Store](#)

### 📖 Overview

The **Linkedin Jobs Scraper** is a powerful data extraction tool designed to aggregate job listings from the Linkedin Jobs search engine.

Whether you're building a job board, analyzing labor market trends, or automating lead generation for recruitment, this actor delivers structured, clean data in real-time.

### ✨ Key Features

- **🌍 Multi-Source Aggregation** – Access listings from thousands of job boards via a single Linkedin search query.
- **🎯 Laser-Focused Filtering** – Filter by specific companies, exact locations, job types (Remote/Contract), and posting dates.
- **⚡ High Performance** – Optimized for speed and low-compute usage to save costs.
- **📅 Fresh Data** – Scrape "Posted 3 days ago" or "Today" to get the newest opportunities first.
- **🔌 API Ready** – Seamlessly integrates with Python, Node.js, Zapier, and Make.com.

### 🛠 Input Parameters

The actor accepts the following input parameters in JSON format.

| Parameter | Type | Required | Description | Default | Valid Values |
|-----------|------|----------|-------------|---------|--------------|
| `countryName` | String | No | The country context for the Linkedin Search domain | "all" | "usa", "uk", "india", etc. |
| `includeKeyword` | String | **Yes** | The main search terms or specific skills | - | Any search string (e.g., "React", "Remote", "Marketing Manager") |
| `locationName` | String | No | Specific city, state, or region | - | Any location string (e.g., "San Francisco, CA") |
| `companyName` | String | No | Filter listings to a specific employer | - | Any company name (e.g., "Linkedin", "Microsoft") |
| `jobType` | String | No | Filters by employment type | - | `FULLTIME`, `PARTTIME`, `CONTRACTOR`, `INTERN` |
| `datePosted` | String | No | How recent the jobs should be | "month" | `today`, `3days`, `week`, `month` |
| `pagesToFetch` | Integer | No | Number of pagination pages to scrape | 1 | Positive integers |

#### 💻 Example Input Configuration

    {
      "countryName": "usa",
      "locationName": "new york",
      "includeKeyword": "software engineer, python",
      "companyName": "linkedin",
      "jobType": "FULLTIME",
      "datePosted": "week",
      "pagesToFetch": 3
    }

### 📊 Output Data

The results are stored in the default Apify dataset. You can download them in JSON, CSV, Excel, or XML formats.

#### Sample JSON Output

    [
      {
        "job_title": "Senior Frontend Developer",
        "company_name": "Tech Corp Inc.",
        "location": "New York, NY (Remote)",
        "posted_via": "LinkedIn",
        "salary": "$120,000 - $150,000 a year",
        "date": "2025-03-25",
        "job_type": "Full-time",
        "URL": "https://www.linkedin.com/search?..."
      }
    ]

#### Field Dictionary

- **job_title:** The official designation of the role.
- **company_name:** The organization hiring.
- **location:** Geographical location or "Remote" status.
- **posted_via:** The original platform where Linkedin found the job (e.g., Monster, Greenhouse, LinkedIn).
- **salary:** Pay range (if provided by the employer).
- **URL:** Direct link to the job application or listing.


### How to Use

1. **Deploy on Apify** – Run the actor directly from the Apify platform.
2. **Schedule & Automate** – Set up periodic runs to keep your job database updated.
3. **Export Data** – Integrate with your CRM, website, or analytics platform.

### Why Use This Actor?

- **No Coding Required** – Easy-to-use with minimal setup.
- **Saves Time** – Automates job data collection.
- **Customizable** – Supports tailored scraping configurations.

### 👨‍💻 Programmatic Usage

You can run this actor via the Apify API using the official client libraries.

#### Python

    from apify_client import ApifyClient

    # Initialize the client with your API token
    client = ApifyClient("YOUR_APIFY_TOKEN")

    # Prepare the Actor input
    run_input = {
        "countryName": "usa",
        "includeKeyword": "Data Scientist",
        "datePosted": "3days",
        "pagesToFetch": 1,
    }

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

    # Fetch and print Actor results from the run's dataset (if there are any)
    for item in client.dataset(run["defaultDatasetId"]).iterate_items():
        print(item)

#### Node.js

    import { ApifyClient } from 'apify-client';

    const client = new ApifyClient({
        token: 'YOUR_APIFY_TOKEN',
    });

    const input = {
        countryName: 'uk',
        includeKeyword: 'DevOps',
        jobType: 'CONTRACTOR',
    };

    (async () => {
        // Run the Actor and wait for it to finish
        const run = await client.actor('orgupdate/linkedin-jobs-scraper').call(input);

        // Fetch and print Actor results from the run's dataset (if there are any)
        const { items } = await client.dataset(run.defaultDatasetId).listItems();
        items.forEach((item) => {
            console.dir(item);
        });
    })();

### 🔗 Integrations

Don't just scrape data—act on it. You can integrate this actor with:

- **Zapier / Make.com:** Trigger an email or Slack notification whenever a new job matching your criteria is posted.
- **Linkedin Sheets:** Automatically save new job listings into a spreadsheet for analysis.
- **Slack/Discord:** Create a bot that alerts your community about new job openings.

### 💡 Use Cases

- **Job Aggregators & Boards:** Populate your niche job board with fresh content daily without manual entry.
- **HR & Recruitment:** Analyze competitor hiring strategies by tracking their open positions.
- **Lead Generation:** Find companies currently hiring for specific roles to pitch your B2B services.
- **Salary Research:** Aggregate salary data across different regions and titles to create market reports.

### 📞 Support & Feedback

If you encounter any issues or have feature requests, please contact us through the Apify Console or check the actor page.

Happy Scraping! 🚀

# Actor input Schema

## `countryName` (type: `string`):

Select the country for job search.
## `companyName` (type: `string`):

Enter the company name to filter job listings.
## `locationName` (type: `string`):

Enter the city or region.
## `includeKeyword` (type: `string`):

Comma-separated keywords (e.g., React, Next.js).
## `pagesToFetch` (type: `integer`):

Number of pages to scrape.
## `jobType` (type: `string`):

Select job type.
## `datePosted` (type: `string`):

Choose time range.

## Actor input object example

```json
{
  "countryName": "",
  "companyName": "",
  "locationName": "",
  "includeKeyword": "",
  "pagesToFetch": 1,
  "datePosted": "all"
}
````

# Actor output Schema

## `jobTitle` (type: `string`):

The title of the job posting.

## `companyName` (type: `string`):

The name of the company.

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

The location of the job posting.

## `postedDate` (type: `string`):

Date when the job was posted.

## `jobUrl` (type: `string`):

Direct link to the job listing.

## `description` (type: `string`):

The full job 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("orgupdate/linkedin-jobs-scraper-api").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("orgupdate/linkedin-jobs-scraper-api").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 '{}' |
apify call orgupdate/linkedin-jobs-scraper-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=orgupdate/linkedin-jobs-scraper-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "LinkedIn Jobs Scraper API",
        "description": "The most advanced enterprise-grade LinkedIn job scraper API. This Indeed job scraper API extracts real-time job postings at scale from any active Indeed Jobs search results worldwide.",
        "version": "0.0",
        "x-build-id": "ow8p1PKb1eCfdxe8d"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/orgupdate~linkedin-jobs-scraper-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-orgupdate-linkedin-jobs-scraper-api",
                "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/orgupdate~linkedin-jobs-scraper-api/runs": {
            "post": {
                "operationId": "runs-sync-orgupdate-linkedin-jobs-scraper-api",
                "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/orgupdate~linkedin-jobs-scraper-api/run-sync": {
            "post": {
                "operationId": "run-sync-orgupdate-linkedin-jobs-scraper-api",
                "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",
                "required": [
                    "countryName",
                    "locationName",
                    "pagesToFetch"
                ],
                "properties": {
                    "countryName": {
                        "title": "Country",
                        "type": "string",
                        "description": "Select the country for job search.",
                        "default": ""
                    },
                    "companyName": {
                        "title": "Company Name",
                        "type": "string",
                        "description": "Enter the company name to filter job listings.",
                        "default": ""
                    },
                    "locationName": {
                        "title": "Location Name",
                        "type": "string",
                        "description": "Enter the city or region.",
                        "default": ""
                    },
                    "includeKeyword": {
                        "title": "Keywords to Include",
                        "type": "string",
                        "description": "Comma-separated keywords (e.g., React, Next.js).",
                        "default": ""
                    },
                    "pagesToFetch": {
                        "title": "Pages to Fetch",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Number of pages to scrape.",
                        "default": 1
                    },
                    "jobType": {
                        "title": "Job Type",
                        "enum": [
                            "FULLTIME",
                            "PARTTIME",
                            "CONTRACTOR",
                            "INTERN"
                        ],
                        "type": "string",
                        "description": "Select job type."
                    },
                    "datePosted": {
                        "title": "Posted in the last",
                        "enum": [
                            "all",
                            "today",
                            "3days",
                            "week",
                            "month"
                        ],
                        "type": "string",
                        "description": "Choose time range.",
                        "default": "all"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```