{
"openapi": "3.0.1",
"info": {
"title": "LinkedIn Jobs Scraper - Listings, Salaries & Details",
"description": "Scrape LinkedIn job search results by keyword and location (title, company, location, posted date, salary, link) with date, distance, Easy Apply and company filters, then full job details: description, salary range, seniority, job type, industries, applicants. No login. Made by ScraperCompany.",
"version": "1.0",
"x-build-id": "lH3d7disy8xThZYN7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapercompany~linkedin-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapercompany-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/scrapercompany~linkedin-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapercompany-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/scrapercompany~linkedin-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapercompany-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": {
"mode": {
"title": "Mode",
"enum": [
"jobs",
"job"
],
"type": "string",
"description": "Search LinkedIn jobs by keyword and location, or read the full details of known postings.",
"default": "jobs"
},
"queries": {
"title": "Job searches (Job search)",
"type": "array",
"description": "What: job title, skill or company words, one search per line, e.g. data analyst, registered nurse.",
"default": [
"data analyst"
],
"items": {
"type": "string"
}
},
"location": {
"title": "Location",
"type": "string",
"description": "Where: a country, state or city, e.g. London, England, United Kingdom. Without a location LinkedIn answers United States results.",
"default": "Toronto, Ontario, Canada"
},
"maxPages": {
"title": "Pages per query",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "How many result pages (10 jobs each) to fetch for each search (1-100). Each page is a separate request and is charged separately; paging stops at the last page LinkedIn has.",
"default": 1
},
"jobIds": {
"title": "Jobs (Job details)",
"type": "array",
"description": "One posting per line: the numeric job id (job_id from Job search results) or a LinkedIn job link such as linkedin.com/jobs/view/4464227292/.",
"default": [
"4464227292"
],
"items": {
"type": "string"
}
},
"posted_within": {
"title": "Posted within",
"enum": [
"day",
"week",
"month"
],
"type": "string",
"description": "Only postings from this period."
},
"distance_miles": {
"title": "Distance (miles)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Radius around the location: one of 0 (exact location), 5, 10, 25, 50 or 100. Other values are rejected."
},
"easy_apply": {
"title": "Easy Apply only",
"type": "boolean",
"description": "Only postings with LinkedIn Easy Apply.",
"default": false
},
"under_10_applicants": {
"title": "Fewer than 10 applicants",
"type": "boolean",
"description": "Only postings with fewer than 10 applicants so far.",
"default": false
},
"geo_id": {
"title": "LinkedIn geo id",
"type": "string",
"description": "LinkedIn's numeric geoId from a linkedin.com jobs search link (e.g. 103644278 United States, 101174742 Canada). Pins the place when the free-text location is ambiguous."
},
"companyIds": {
"title": "Company ids",
"type": "array",
"description": "Only jobs at these companies: LinkedIn numeric company ids (job.company_id in Job details results), up to 20.",
"items": {
"type": "string"
}
},
"page": {
"title": "Start page",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Result page to start from (1-100).",
"default": 1
},
"customRequests": {
"title": "Custom requests (advanced)",
"type": "array",
"description": "Optional list of JSON objects, one request each, using the API field names shown above. Each object is merged over the options above, so you only need to give what differs. Add \"mode\": \"job\" with a job_id to mix in job details. Example: {\"keywords\":\"nurse\",\"location\":\"Austin, Texas\",\"distance_miles\":25,\"posted_within\":\"week\"}"
},
"includeErrors": {
"title": "Include failed requests in the dataset",
"type": "boolean",
"description": "When on, a request that fails (for example an unknown property id) is saved as a dataset item with an error message so you can see what went wrong. Failed requests are never charged.",
"default": true
},
"maxConcurrency": {
"title": "Parallel requests",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "How many API requests run at the same time (1-8). Parallel runs share one limit, so extra requests wait for a free slot instead of failing.",
"default": 3
},
"maxRetries": {
"title": "Retries per request",
"minimum": 0,
"maximum": 5,
"type": "integer",
"description": "Retries for rate limits (HTTP 429), temporary server errors (5xx) and network errors, with exponential backoff. Validation errors are never retried.",
"default": 2
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}