{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Search Scraper", "description": "Search LinkedIn jobs and extract the full posting: description, criteria, applicants, hiring contact, salary and company firmographics. No browser, no login.", "version": "0.0", "x-build-id": "u2ft7cA68NNMi819x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knowten~linkedin-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knowten-linkedin-jobs-search-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/knowten~linkedin-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-knowten-linkedin-jobs-search-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/knowten~linkedin-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-knowten-linkedin-jobs-search-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": "Keywords", "type": "string", "description": "What to search for, exactly as you would type it in LinkedIn's job search box." }, "location": { "title": "Location", "type": "string", "description": "City, region or country. Resolved to LinkedIn's internal geoId automatically." }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many job postings to return. Set as high as you like - the Actor stops on its own once a query is exhausted. In practice a single keywords+location combination yields roughly 100-350 unique jobs from LinkedIn's public search, regardless of this value; run several narrower queries (different cities, seniority levels, or weeks) to accumulate more.", "default": 100 }, "datePosted": { "title": "Date posted", "enum": [ "any", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Only return jobs posted within this window.", "default": "any" }, "jobTypes": { "title": "Job type", "type": "array", "description": "Contract type. Leave empty for all. LinkedIn ignores this filter server-side for anonymous requests, so it is enforced by the Actor itself after reading each job's detail page - this automatically turns \"Scrape full job details\" on if you had it off, and the search keeps going past \"Max jobs\" worth of raw postings until it actually finds that many matches, up to a cap of 20x \"Max jobs\" postings scanned - so a narrow type like Volunteer costs more requests than the job count implies, and may return fewer than \"Max jobs\" if that type is rare for your search.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] }, "default": [] }, "experienceLevels": { "title": "Experience level", "type": "array", "description": "Seniority filter. Leave empty for all.", "items": { "type": "string", "enum": [ "internship", "entryLevel", "associate", "midSenior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] }, "default": [] }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order search results by relevance or by posting date.", "default": "relevance" }, "scrapeJobDetails": { "title": "Scrape full job details", "type": "boolean", "description": "Fetch each posting's page for the full description, seniority, employment type, industries, applicant count, hiring contact and salary. Costs one extra request per job.", "default": true }, "scrapeCompanyDetails": { "title": "Scrape company details", "type": "boolean", "description": "Also fetch each company's public page for industry, size, headquarters, website, type, specialties and follower count. One request per unique company (cached), so the cost is low.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Parallel HTTP requests. Measured safe defaults: 6-8 without proxy rotation, 15-25 with Apify Proxy enabled (a rotating proxy spreads LinkedIn's own per-IP rate limit across many exit IPs, so higher concurrency stays safe). The Actor barely uses CPU/RAM even at high values - raise this first if a run feels slow. Lower it only if you start getting blocked.", "default": 6 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Base delay applied before every request; random jitter is added on top. This is a direct throughput lever - it gates every single request, so it matters more than it looks. With Apify Proxy rotating IPs, try lowering it to 100-150ms for large runs.", "default": 250 }, "impersonate": { "title": "Browser fingerprint", "enum": [ "chrome", "safari", "firefox", "edge", "chrome_android", "safari_ios" ], "type": "string", "description": "TLS/HTTP2 fingerprint presented to LinkedIn.", "default": "chrome" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "LinkedIn's public job endpoints tolerate datacenter IPs well. Switch to residential only if you see blocks.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }