{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "Scrape job listings from LinkedIn. Search by keywords, location, job type, experience level, and more. Extract job details, company information, and application links.", "version": "1.0", "x-build-id": "iwmQuvdq13UwdW56G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/artificially~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-artificially-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/artificially~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-artificially-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/artificially~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-artificially-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 Keywords", "type": "array", "description": "Job search keywords, one query per line; each is searched separately, e.g. \"data engineer\" or \"product manager fintech\". Required.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to search in, as you would type it on LinkedIn Jobs: a city, region or country, e.g. \"Berlin, Germany\", \"San Francisco Bay Area\", \"United States\". Leave empty for worldwide." }, "maxJobs": { "title": "Max Jobs Per Query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to save per search query. Integer 1-1000, e.g. 25. LinkedIn returns at most about 1000 jobs per search. Use a small number (10-25) for quick answers.", "default": 100 }, "jobType": { "title": "Job Type", "type": "array", "description": "Filter by employment type. Array of any of: \"full-time\", \"part-time\", \"contract\", \"temporary\", \"internship\", \"volunteer\", e.g. [\"full-time\", \"contract\"]. Empty for all types.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "temporary", "internship", "volunteer" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer" ] } }, "experienceLevel": { "title": "Experience Level", "type": "array", "description": "Filter by seniority. Array of any of: \"internship\", \"entry\", \"associate\", \"mid-senior\", \"director\", \"executive\", e.g. [\"mid-senior\"]. Empty for all levels.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "mid-senior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "datePosted": { "title": "Date Posted", "enum": [ "any", "past-24h", "past-week", "past-month" ], "type": "string", "description": "Only return jobs posted within this window. One of: \"any\", \"past-24h\", \"past-week\", \"past-month\". Default \"any\".", "default": "any" }, "remoteFilter": { "title": "Workplace Type", "enum": [ "any", "remote", "on-site", "hybrid" ], "type": "string", "description": "Filter by workplace type. One of: \"any\", \"remote\", \"on-site\", \"hybrid\". Default \"any\".", "default": "any" }, "maxAttemptsPerPage": { "title": "Max attempts per page", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many times to retry a search results page that LinkedIn blocks or rate-limits (HTTP 999/429, login wall), each attempt on a fresh proxy IP with exponential backoff. Integer 1-12, e.g. 6. Blocked pages are never saved or charged.", "default": 6 }, "residentialFallback": { "title": "Residential proxy fallback", "type": "boolean", "description": "If true, after half of the attempts fail on the selected proxy, the remaining attempts go through Apify residential proxies, which LinkedIn blocks far less often. Only applies on the Apify platform. Recommended: true.", "default": true }, "compactOutput": { "title": "Compact output (for AI agents)", "type": "boolean", "description": "If true, save a slimmer item per job with only: jobId, title, company, companyUrl, location, listingDateParsed, jobUrl. Drops the logo URL, relative listing date, searchQuery and scrapedAt. Recommended for AI agents and LLM pipelines. Default false keeps the full item.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Proxy is strongly recommended because LinkedIn blocks most unproxied traffic. Leave the default {\"useApifyProxy\": true} unless you have your own proxies." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }