{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "Scrape LinkedIn job postings without a login or cookie. Get titles, companies, locations, salaries, posting dates, applicant counts, seniority, employment type and full job descriptions. Paste a LinkedIn search URL or give keywords and locations.", "version": "0.1", "x-build-id": "38LztnNvjpsS06V3n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jmlp~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jmlp-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/jmlp~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-jmlp-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/jmlp~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-jmlp-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": { "searchUrls": { "title": "LinkedIn search URLs", "type": "array", "description": "Paste LinkedIn job-search URLs straight from your address bar after applying filters in the UI. Every filter in the URL is honoured, which is far easier than reproducing them below by hand. This is the recommended input.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Job titles or skills, e.g. 'python developer'. Each keyword is combined with each location below, so 3 keywords x 2 locations is 6 searches.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities, regions or countries as LinkedIn spells them, e.g. 'London', 'Berlin', 'United States'.", "items": { "type": "string" } }, "geoId": { "title": "Geo ID", "type": "string", "description": "LinkedIn's numeric location id, taken from a search URL. More precise than a location name when several places share one." }, "companyIds": { "title": "Company IDs", "type": "array", "description": "Restrict results to these LinkedIn company ids (the f_C value in a search URL).", "items": { "type": "string" } }, "datePosted": { "title": "Date posted", "enum": [ "any", "month", "week", "day" ], "type": "string", "description": "How recent the posting must be.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance is LinkedIn's default; date gives you the newest postings first, which is what you want when running this on a schedule.", "default": "relevance" }, "experienceLevel": { "title": "Experience level", "type": "array", "description": "Any of: internship, entry, associate, mid-senior, director, executive.", "items": { "type": "string" } }, "jobType": { "title": "Employment type", "type": "array", "description": "Any of: full-time, part-time, contract, temporary, volunteer, internship, other.", "items": { "type": "string" } }, "workplaceType": { "title": "Workplace type", "type": "array", "description": "Any of: on-site, remote, hybrid.", "items": { "type": "string" } }, "distance": { "title": "Distance (miles)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius around the location." }, "scrapeJobDetails": { "title": "Scrape full job descriptions", "type": "boolean", "description": "Adds the full description, seniority level, employment type, job function, industries and applicant count. This costs ONE EXTRA REQUEST PER JOB and is what LinkedIn throttles first - measured at a couple of dozen from a single IP. Use a proxy when this is on, or turn it off for a fast list of cards.", "default": true }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Stop after this many unique jobs across every search. Caps both runtime and cost. Prefilled so a first run finishes quickly." }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "type": "integer", "description": "Safety cap per search. One page is 10 jobs - LinkedIn's page size is fixed and cannot be raised." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to run in parallel. LinkedIn throttles by IP, so higher is not always faster - 2 is a good balance, and raise it only with a proxy.", "default": 2 }, "delayMs": { "title": "Delay between requests (ms)", "minimum": 0, "type": "integer", "description": "Politeness pause. This is the main lever against being throttled; raise it if the log reports refused searches.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Strongly recommended, especially with descriptions on. LinkedIn throttles a single IP quickly and the job-description endpoint hits that limit long before the search does.", "default": { "useApifyProxy": true } }, "proxyRotations": { "title": "Proxy rotation attempts", "minimum": 1, "maximum": 6, "type": "integer", "description": "If a search is throttled, mint a new proxy session and retry this many times.", "default": 3 }, "resume": { "title": "Checkpoint progress", "type": "boolean", "description": "Save progress every ~30s so a migrated or restarted run picks up where it stopped.", "default": true }, "continueFromLastRun": { "title": "Continue from last run", "type": "boolean", "description": "If your previous run with the same input was interrupted or throttled, fetch only what it missed. Earlier jobs stay in THAT run's dataset.", "default": false }, "impersonate": { "title": "TLS fingerprint", "type": "string", "description": "Which browser TLS fingerprint to present. LinkedIn refuses plain HTTP clients outright, so this must stay a real browser build.", "default": "chrome131" } } }, "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 } } } } } } } } } }