{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "Scrape LinkedIn job listings without a login or cookie: job titles, companies, company pages and logos, locations, posting dates, salary ranges, seniority, employment type and full descriptions for any keyword and place.", "version": "0.1", "x-build-id": "QZ6szwGOKbu1MmFeE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammad4hmed~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammad4hmed-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/muhammad4hmed~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-muhammad4hmed-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/muhammad4hmed~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-muhammad4hmed-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Job titles or keywords to search for, e.g. \"software engineer\" or \"registered nurse\". Each query is run against every location.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Free-text places LinkedIn geocodes, e.g. \"United States\", \"Texas, United States\", \"London, England, United Kingdom\". Do not enter \"Remote\" here — it geocodes to nothing coherent; use the Remote only toggle instead.", "default": [ "United States" ], "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max results per query and location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many jobs to keep for each query/location pair. LinkedIn's public search stops serving results past offset 1000, so this is capped at 1000.", "default": 100 }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only remote jobs. LinkedIn publishes no workplace-type field on its logged-out pages, so this appends \"remote\" to the search keywords and then keeps only jobs whose TITLE says remote (\"Backend Engineer (Remote)\", \"... | Remote\", work from home, WFH). It is a real filter and it cuts results hard — typically 5-15 rows per 80 cards scanned.", "default": false }, "maxAgeDays": { "title": "Max age (days)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only jobs posted within this many days. 0 means any date. This maps to LinkedIn's own date-posted filter and is verified to genuinely bound the results.", "default": 0 }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Only jobs you can apply to without leaving LinkedIn. This is a real server-side LinkedIn filter and needs no extra requests.", "default": false }, "fetchJobDetails": { "title": "Fetch job details", "type": "boolean", "description": "Open each job page to add seniority level, employment type, job function, industries, applicant count, salary, Easy Apply flag and the full description. Costs one extra request per job and is billed as a separate event.", "default": false }, "experienceLevel": { "title": "Experience level", "enum": [ "any", "internship", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Filter by seniority. Requires \"Fetch job details\" — LinkedIn ignores its own experience-level parameter on public search, so this is applied to the value read from each job page. Warning: about 90% of real LinkedIn jobs report \"Not Applicable\", so any setting other than \"any\" discards most results.", "default": "any" }, "jobType": { "title": "Job type", "enum": [ "any", "full-time", "part-time", "contract", "temporary", "internship" ], "type": "string", "description": "Filter by employment type. Requires \"Fetch job details\" — LinkedIn ignores its own job-type parameter on public search, so this is applied to the value read from each job page.", "default": "any" }, "maxItems": { "title": "Max items (whole run)", "minimum": 0, "type": "integer", "description": "Hard cap on total jobs across all queries and locations. 0 means no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "LinkedIn blocks Apify's datacenter IPs, so residential proxy is required. Leave this as it is unless you know what you are changing.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }