{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper — Full Descriptions, Only New Jobs", "description": "Scrape LinkedIn job listings by keyword, location and filters, with the full job description, seniority, employment type, industry and applicant count included on every row. Built-in 'only new jobs' mode for scheduled monitoring. No login, no cookies.", "version": "1.0", "x-build-id": "5d0bBY0HU2RlLEQAM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cycha~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cycha-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/cycha~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-cycha-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/cycha~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-cycha-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": "array", "description": "One search per entry, e.g. 'python developer', 'account executive'. Leave empty to list all jobs in the location.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region or country as you would type it on LinkedIn, e.g. 'Paris', 'Germany', 'United States', 'Remote'." }, "datePosted": { "title": "Date posted", "enum": [ "any", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Only jobs posted within this window.", "default": "any" }, "jobTypes": { "title": "Job type", "type": "array", "description": "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" ] } }, "experienceLevels": { "title": "Experience level", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "midSenior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "workplaceTypes": { "title": "Workplace", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "onsite", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "recent" ], "type": "string", "description": "Most relevant (LinkedIn's default) or newest first. 'Only new jobs' forces newest first.", "default": "relevance" }, "searchUrls": { "title": "LinkedIn search URLs", "type": "array", "description": "Optional. Paste job search URLs from linkedin.com/jobs/search; keywords, location and filters are read from the URL.", "items": { "type": "string" } }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 0, "maximum": 1000, "type": "integer", "description": "LinkedIn shows at most 1,000 jobs per search. 0 = up to that limit.", "default": 100 }, "includeDetails": { "title": "Include full job details", "type": "boolean", "description": "Fetch each job page for the full description, seniority, employment type, job function, industries and applicant count. Included in the price.", "default": true }, "onlyNewJobs": { "title": "Only new jobs (for schedules)", "type": "boolean", "description": "Remember jobs delivered by earlier runs of the same searches and return only jobs not seen before, even when another search of the task found them. Sorts by most recent. You only pay for new jobs.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, off by default and not needed. You can use Apify datacenter proxies or your own proxy URLs. Residential proxies are not supported and are replaced by datacenter 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 } } } } } } } } } }