{ "openapi": "3.0.1", "info": { "title": "LinkedIn Job Scraper API - Salary, Skills & Full Descriptions", "description": "LinkedIn job scraper tool that searches by keyword and location and returns every posting with the full description, salary, skills, and applicant count. No login or cookies.", "version": "0.1", "x-build-id": "Iqu1BOAsDWrIebYks" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thodor~linkedin-job-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thodor-linkedin-job-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/thodor~linkedin-job-scraper-api/runs": { "post": { "operationId": "runs-sync-thodor-linkedin-job-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/thodor~linkedin-job-scraper-api/run-sync": { "post": { "operationId": "run-sync-thodor-linkedin-job-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", "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "What to search for, one term per line. Each term runs as its own search, and a job found by two terms is only returned once.", "default": [ "python developer" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Where to search, written the way you would type it on LinkedIn: `Berlin, Germany`, `London, United Kingdom`, `United States`. Leave empty to search worldwide. Applies to every keyword.", "default": "" }, "postedWithin": { "title": "Posted within", "enum": [ "any", "24h", "7d", "30d" ], "type": "string", "description": "Only return jobs posted inside this window. Narrowing it makes runs much faster and is the reliable way to get recent postings, because LinkedIn ignores any request to sort by date.", "default": "any" }, "jobType": { "title": "Job type", "enum": [ "any", "fulltime", "parttime", "contract", "temporary", "internship", "volunteer", "other" ], "type": "string", "description": "Filter by employment type. LinkedIn applies this itself, but relaxes it when too few postings match, so a narrow search can still return adjacent types. Check the `employment_type` field on each row if it matters.", "default": "any" }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 0, "type": "integer", "description": "Stop after this many jobs per keyword. Defaults to 25 so a first run finishes quickly. **Set it to 0 for everything LinkedIn will serve**, which is up to 1,000 per search.", "default": 25 }, "scrapeDetails": { "title": "Scrape full job details (free)", "type": "boolean", "description": "Open each job to collect the full description, salary, skills, applicant count, seniority, and expiry date. Turn it off for a much faster run that returns only what the search results page shows.", "default": true }, "enrichCompanies": { "title": "Add company details (add-on)", "type": "boolean", "description": "Attach the employer's industry, exact headcount, follower count, HQ, founded year, and website to every job. Billed separately from the jobs, once per company per run no matter how many of its jobs you get, and only when the lookup succeeds.", "default": false }, "searchUrls": { "title": "Search URLs (optional)", "type": "array", "description": "Paste LinkedIn job search URLs instead of typing keywords. Build the search on LinkedIn, copy the address bar, drop it here. The keywords and location are read from the URL; other LinkedIn filters in it are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }