{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "Scrape LinkedIn jobs by keyword, location, company & filters — no login or cookies needed. Returns title, company, logo, location, salary, seniority, full description, applicants count and more. Fast, reliable, built for scale.", "version": "1.5", "x-build-id": "nfOYOD4W4expLDOag" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/osamih~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-osamih-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/osamih~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-osamih-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/osamih~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-osamih-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": [ "title", "location", "rows", "proxy" ], "properties": { "title": { "title": "Job title / keywords", "type": "string", "description": "Keywords to search for (e.g. Web developer). Quoted phrases are supported. Can be left empty when filtering by company.", "default": "" }, "location": { "title": "Job location", "type": "string", "description": "Free-text location of the job (e.g. Paris, New York, United States).", "default": "United States" }, "companyName": { "title": "Company names", "type": "array", "description": "Names of companies to filter by (e.g. Google, NASA). Names are resolved to LinkedIn company IDs automatically; names that cannot be resolved fall back to a quoted keyword search.", "items": { "type": "string" } }, "companyId": { "title": "Company IDs (advanced)", "type": "array", "description": "Numeric LinkedIn company IDs to filter by (LinkedIn's f_C parameter, e.g. 1441 for Google). Use this for exact company targeting when a name is ambiguous. To find an ID, open the company page and copy the number from the URL, or apply a company filter on linkedin.com/jobs and read f_C from the URL. Multiple IDs are OR-combined and merged with any resolved company names.", "items": { "type": "string" } }, "publishedAt": { "title": "Date posted", "enum": [ "", "r2592000", "r604800", "r86400" ], "type": "string", "description": "Only return jobs published within this time range.", "default": "" }, "workType": { "title": "On-site / Remote", "enum": [ "", "1", "2", "3" ], "type": "string", "description": "Filter by workplace type.", "default": "" }, "contractType": { "title": "Job type", "enum": [ "", "F", "P", "C", "T", "I", "V", "O" ], "type": "string", "description": "Filter by employment type.", "default": "" }, "experienceLevel": { "title": "Experience level", "enum": [ "", "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Filter by required experience level.", "default": "" }, "jobFunctions": { "title": "Job functions", "type": "array", "description": "Filter by LinkedIn job function (the \"Job function\" filter on linkedin.com/jobs). Multiple selections are OR-combined.", "items": { "type": "string", "enum": [ "acct", "adm", "advr", "anls", "art", "bd", "cnsl", "cust", "dist", "dsgn", "edu", "eng", "fin", "genb", "hcpr", "hr", "it", "lgl", "mgmt", "mnfc", "mrkt", "othr", "pr", "prch", "prdm", "prjm", "prod", "qa", "rsch", "sale", "sci", "stra", "supl", "trng", "wrt" ], "enumTitles": [ "Accounting/Auditing", "Administrative", "Advertising", "Analyst", "Art/Creative", "Business Development", "Consulting", "Customer Service", "Distribution", "Design", "Education", "Engineering", "Finance", "General Business", "Health Care Provider", "Human Resources", "Information Technology", "Legal", "Management", "Manufacturing", "Marketing", "Other", "Public Relations", "Purchasing", "Product Management", "Project Management", "Production", "Quality Assurance", "Research", "Sales", "Science", "Strategy/Planning", "Supply Chain", "Training", "Writing/Editing" ] } }, "industryIds": { "title": "Industry IDs", "type": "array", "description": "Numeric LinkedIn industry codes to filter by (e.g. 4 = Software Development, 43 = Financial Services, 14 = Hospitals and Health Care). Multiple IDs are OR-combined. Full list of codes: https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2", "items": { "type": "string" } }, "titleIds": { "title": "Job title IDs (advanced)", "type": "array", "description": "Numeric LinkedIn title IDs for exact-title filtering (LinkedIn's f_T parameter). To find an ID, apply a \"Title\" filter on linkedin.com/jobs and copy the f_T value from the URL. Multiple IDs are OR-combined.", "items": { "type": "string" } }, "minSalary": { "title": "Minimum salary", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9" ], "type": "string", "description": "Only jobs above this annual salary. Uses LinkedIn's salary filter — applies only where LinkedIn has salary data (mostly US searches).", "default": "" }, "easyApply": { "title": "Easy Apply only", "type": "boolean", "description": "Only return jobs that can be applied to directly on LinkedIn (Easy Apply).", "default": false }, "under10Applicants": { "title": "Be an early applicant (under 10 applicants)", "type": "boolean", "description": "Only return jobs with fewer than 10 applicants so far (LinkedIn's \"Be an early applicant\" filter). Useful for applying before a posting gets crowded.", "default": false }, "distance": { "title": "Distance (miles)", "minimum": 0, "type": "integer", "description": "Search radius around the location in miles (e.g. 25). 0 = LinkedIn's default radius. Only meaningful for city-level locations.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "", "R", "DD" ], "type": "string", "description": "Order of search results. \"Most recent first\" is useful for monitoring new postings.", "default": "" }, "postedWithinSeconds": { "title": "Posted within (seconds)", "minimum": 0, "type": "integer", "description": "Custom freshness window in seconds, finer than \"Date posted\" (e.g. 3600 = past hour). Overrides \"Date posted\" when set. 0 = disabled.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxies used for scraping. Residential proxies are strongly recommended — LinkedIn blocks datacenter IPs aggressively.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "rows": { "title": "Number of results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many jobs to scrape. LinkedIn caps a single search at ~1,000 results; above 1,000 the actor automatically splits the search into multiple sub-queries.", "default": 50 } } }, "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 } } } } } } } } } }