{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper - Job Listings with Full Description", "description": "Scrape LinkedIn job listings by keyword and location, or paste LinkedIn job search URLs. Title, company, location and date as clean JSON. Optional full description, seniority, employment type and applicant count. From $0.50 per 1,000 jobs, no login, no cookies.", "version": "0.1", "x-build-id": "NeAbzwnSkei7j1zo3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasignalslab~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasignalslab-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/datasignalslab~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-datasignalslab-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/datasignalslab~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-datasignalslab-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": { "queries": { "title": "Search terms", "type": "array", "description": "One per line, for example a job title or a skill. Each term is searched in each location below.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Optional, one per line: a city, region or country as you would type it on LinkedIn. Each search term is run once per location, so 3 terms and 10 locations are 30 searches.", "items": { "type": "string" } }, "startUrls": { "title": "LinkedIn search URLs", "type": "array", "description": "Optional. Set your filters on linkedin.com/jobs in the browser and paste the URL of the result page. Can be combined with search terms.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "postedWithin": { "title": "Posted within", "enum": [ "any", "24h", "week", "month" ], "type": "string", "description": "Only jobs posted in this period.", "default": "any" }, "sort": { "title": "Sort", "enum": [ "date", "relevance" ], "type": "string", "description": "Newest first is the right choice for scheduled monitoring.", "default": "date" }, "jobTypes": { "title": "Job types", "type": "array", "description": "Optional. Leave empty for all.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "temporary", "internship" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship" ] } }, "workplace": { "title": "Workplace", "type": "array", "description": "Optional. Leave empty for all.", "items": { "type": "string", "enum": [ "on-site", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "experienceLevels": { "title": "Experience levels", "type": "array", "description": "Optional. Leave empty for all.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "mid-senior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "LinkedIn shows at most 1,000 jobs per search without a login.", "default": 100 }, "maxJobs": { "title": "Max jobs in this run", "minimum": 0, "type": "integer", "description": "Hard stop across all searches, also your budget cap. 0 means no limit.", "default": 0 }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Adds the full job description, seniority level, employment type, job function, industries and applicant count. Charged per description on top of the job.", "default": false } } }, "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 } } } } } } } } } }