{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper", "description": "Scrape public LinkedIn job postings — title, company, location, salary, description and applicant count. No login, no cookies, no proxies.", "version": "0.1", "x-build-id": "kRzrcXimmzshbMyOl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bercikgroup~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bercikgroup-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/bercikgroup~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-bercikgroup-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/bercikgroup~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-bercikgroup-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": "Keywords", "type": "string", "description": "What to search for, exactly as you would type it into LinkedIn — e.g. \"data engineer\", \"product manager\". Leave blank to get everything matching your other filters." }, "location": { "title": "Location", "type": "string", "description": "Where to search, e.g. \"United States\", \"London, England, United Kingdom\", \"Remote\". Use the same wording LinkedIn suggests in its own location box." }, "datePosted": { "title": "Date posted", "enum": [ "any", "past24Hours", "pastWeek", "pastMonth" ], "type": "string", "description": "Only return jobs posted within this window.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance is LinkedIn's own ranking. Most recent is better for monitoring, since new postings appear first.", "default": "relevance" }, "jobTypes": { "title": "Job type", "type": "array", "description": "Employment types to include. Leave empty for all.", "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 levels to include. Leave empty for all.", "items": { "type": "string", "enum": [ "internship", "entryLevel", "associate", "midSeniorLevel", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] }, "default": [] }, "workplaceTypes": { "title": "Workplace type", "type": "array", "description": "On-site, remote or hybrid. Leave empty for all.", "items": { "type": "string", "enum": [ "onSite", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] }, "default": [] }, "scrapeDetails": { "title": "Include full job details", "type": "boolean", "description": "Open each posting to add the full description, seniority level, job function, industries, applicant count and salary range. This makes the run roughly 10x longer, because it needs one extra request per job.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Hard cap on job records returned. You are charged per record. Note that LinkedIn returns at most 1,000 jobs for any single search — add more searches to go beyond that.", "default": 200 }, "searchQueries": { "title": "Multiple searches (advanced)", "type": "array", "description": "Run several searches in one go. Each entry is an object like {\"keywords\": \"data engineer\", \"location\": \"Berlin\"}. Filters above apply to every search unless the entry overrides them. Results are deduplicated by job ID." }, "geoId": { "title": "LinkedIn geo ID", "type": "string", "description": "Optional. LinkedIn's internal location ID, taken from the geoId parameter in a LinkedIn jobs search URL. More precise than a location name when a place name is ambiguous." }, "companyId": { "title": "LinkedIn company ID", "type": "string", "description": "Optional. Restrict results to one company, using the numeric ID from the f_C parameter of a LinkedIn jobs search URL." }, "requestIntervalMs": { "title": "Delay between requests (ms)", "minimum": 250, "maximum": 5000, "type": "integer", "description": "How long to wait between requests. The default of 500ms is the fastest pace that runs cleanly. Raise it if you see rate-limit warnings in the log.", "default": 500 } } }, "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 } } } } } } } } } }