{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "[💰 $0.95 / 1K] Extract LinkedIn job postings at scale — title, company, location, salary, description, seniority, employment type, applicant count, and recruiter details. Search by keyword and location with date, job-type, experience-level, and remote filters, or paste LinkedIn search URLs.", "version": "1.0", "x-build-id": "clpUducUnrNdYob9c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": { "keywords": { "title": "Search Keywords", "type": "string", "description": "Job title, skill, or keyword to search for (e.g., 'Python developer', 'product manager', 'nurse'). Leave empty if you are only using LinkedIn URLs below." }, "location": { "title": "Location", "type": "string", "description": "City, region, or country to search in (e.g., 'New York', 'United Kingdom', 'Remote — Germany'). Matches what you would type into LinkedIn's location box." }, "startUrls": { "title": "LinkedIn Job Search URLs", "type": "array", "description": "Full LinkedIn job-search URLs, copied from your browser. Keyword, location, date-posted and company filters in the URL are applied. Experience level, job type, workplace type, industry and salary filters are NOT — LinkedIn only applies those for signed-in visitors, so a URL using them returns a wider set of jobs here than it shows in your browser. The run warns you when it sees one.", "items": { "type": "string" } }, "datePosted": { "title": "Date Posted", "enum": [ "any", "month", "week", "day" ], "type": "string", "description": "Only return jobs posted within this time window.", "default": "any" }, "companyUrls": { "title": "Companies", "uniqueItems": true, "type": "array", "description": "Only return jobs from these companies. Paste the address of each company's LinkedIn page, e.g. https://www.linkedin.com/company/microsoft. Leave empty to search every company.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort By", "enum": [ "relevant", "recent" ], "type": "string", "description": "Order results by relevance, or by most recently posted. Most recent returns the freshest jobs first, ordered by posting date — it checks a wider pool of listings before picking the newest ones, so those runs take a little longer.", "default": "relevant" }, "scrapeCompanyDetails": { "title": "Scrape company details", "type": "boolean", "description": "Also fetch each job's company profile (description, website, employee count, industry). This adds an extra request per unique company and makes the run slower. Turn off to keep runs fast and only collect the job posting itself.", "default": true }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Total number of jobs to return across all searches and URLs. When a run has more than one search (keywords plus URLs, or several URLs), they share this total and run in order, so a later search returns nothing once the total is used up. Use 0 for unlimited instead: every search then runs on its own until LinkedIn runs out of jobs, so a run with 3 searches can return roughly 3,000 jobs and you are billed for all of them. LinkedIn caps each individual search at roughly 1,000 jobs — to go deeper, run several narrower searches (by location, date, or job type).", "default": 100 } } }, "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 } } } } } } } } } }