{ "openapi": "3.0.1", "info": { "title": "LinkedIn Search Jobs Scraper By Multiple Keywords & Locations", "description": "The LinkedIn Search Jobs Scraper actor collects job listings from LinkedIn based on keywords, locations, and filters. It extracts titles, companies, locations, posting dates, and job URLs. Ideal for recruiters, analysts, and job platforms needing automated LinkedIn job market data collection.", "version": "0.1", "x-build-id": "3OowbHhU2NrFCeUfs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~linkedin-search-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-linkedin-search-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/scraper-engine~linkedin-search-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-linkedin-search-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/scraper-engine~linkedin-search-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-linkedin-search-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": { "targets": { "title": "🧩 Bulk Search Targets (Keyword x Location Matrix)", "type": "array", "description": "One line per target: 'keywords @ location1; location2'. Everything before '@' is the keyword search (use 'term1|term2' for an OR search, same syntax as the Legacy field below); everything after '@' is one or more locations separated by ';' — each location becomes its own search (cross-product). Example: 'software engineer|backend developer @ United States; United Kingdom' runs 2 searches (one per location) for that OR-keyword pair. Add a 2nd line 'product manager @ United States' to add a 3rd search, 3 total. Each location is auto-resolved to LinkedIn's numeric geoId.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Legacy URLs / Keywords (Bulk Input)", "type": "array", "description": "Backward-compatible with the base actor's input: LinkedIn job search URLs, keywords, company URLs, structured 'keyword, location' strings, or job URLs/IDs — one item per line. Each item is treated as one additional implicit target alongside 'targets' above. Leave empty if you only use the Bulk Search Targets matrix.", "items": { "type": "string" } }, "sortOrder": { "title": "↕️ Sort Order", "enum": [ "relevant", "recent" ], "type": "string", "description": "Choose how to sort results within each target: most relevant or most recent.", "default": "relevant" }, "maxJobs": { "title": "🔢 Max Jobs Per Target", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to scrape for EACH target/search (range 1-10000). Note: LinkedIn's guest search surface has a real hard ceiling of about 1000 jobs per target regardless of this value — the coverageSummary row reports maxJobsRequested vs maxJobsDelivered honestly if the ceiling is hit.", "default": 25 }, "maxTargets": { "title": "🧮 Max Targets To Run", "minimum": 0, "type": "integer", "description": "Safety cap on how many expanded keyword x location targets (after cross-product) will actually run in one job, so a large matrix can't runaway. 0 = no cap.", "default": 0 }, "proxyConfiguration": { "title": "🛡️ Proxy Configuration (Optional)", "type": "object", "description": "Optional: enable Apify proxy if requests get blocked. By default the actor runs with direct requests (no proxy). Proxies may consume extra credits." } } }, "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 } } } } } } } } } }