{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "LinkedIn Jobs Scraper returns public job listings from LinkedIn by keywords, location, and filters. Scrape job titles, companies, salaries, descriptions, and applicant counts from LinkedIn's public guest job search API.", "version": "0.0", "x-build-id": "DoOUGfhFCzRQVeBcn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatatools~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatatools-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/webdatatools~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-webdatatools-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/webdatatools~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-webdatatools-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": { "keywords": { "title": "Search keywords", "type": "string", "description": "Job title or skills to search for, e.g. \"data analyst\". Separate several searches with a semicolon: \"python; golang\". Leave empty with a company filter to list all of a company's jobs." }, "location": { "title": "Location", "type": "string", "description": "City, region or country, e.g. \"Berlin\", \"Austin, TX\" or \"Germany\". Leave empty to search worldwide." }, "locations": { "title": "More locations (optional)", "type": "array", "description": "Run the same search in several places, e.g. [\"London\", \"Manchester\"]. Combined with Location.", "items": { "type": "string" } }, "datePosted": { "title": "Date Posted Filter", "enum": [ "", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Filter jobs by posting date. Leave empty to include all jobs.", "default": "" }, "workType": { "title": "Work Type", "type": "array", "description": "Filter by work type (onsite, remote, hybrid). Leave empty to include all.", "default": [] }, "experienceLevel": { "title": "Experience Level", "type": "array", "description": "Filter by experience level. Leave empty to include all. Valid values: internship, entry_level, associate, mid_level, senior, manager, director, executive.", "default": [] }, "titleIncludes": { "title": "Title must include", "type": "array", "description": "Keep only jobs whose title contains one of these words or phrases. Case-insensitive, whole words. Leave empty to keep all titles.", "items": { "type": "string" } }, "titleExcludes": { "title": "Title must not include", "type": "array", "description": "Drop jobs whose title contains one of these words or phrases, e.g. senior, staff, intern. Case-insensitive, whole words. Dropped jobs are not returned and not charged.", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Drop jobs from these company names (case-insensitive, whole names). Dropped jobs are not returned and not charged.", "items": { "type": "string" } }, "externalApplyOnly": { "title": "Company site apply only", "type": "boolean", "description": "Return only jobs that apply on the company site. Costs one detail-page request per candidate job." }, "jobType": { "title": "Job Type", "type": "array", "description": "Filter by job type (full-time, part-time, contract, temporary, internship, volunteer). Leave empty to include all.", "default": [] }, "maxJobs": { "title": "Maximum jobs to scrape", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to scrape, e.g. 100. LinkedIn search results are capped at ~1,000 total.", "default": 25 }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Fetch full job descriptions (requires extra API calls). Leave unchecked to skip descriptions.", "default": true }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Alternative: paste LinkedIn job search URLs (e.g., https://www.linkedin.com/jobs/search/?keywords=python&location=USA). Parameters will be mapped to the guest API.", "default": [], "items": { "type": "string" } }, "proxyMode": { "title": "Proxy mode", "enum": [ "auto", "always", "never" ], "type": "string", "description": "How to use Apify Proxy: 'auto' (direct first, escalate to residential on blocks), 'always' (always use residential), 'never' (direct only).", "default": "auto" } } }, "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 } } } } } } } } } }