{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper - Fast, Cheap & No Login Required", "description": "Scrape LinkedIn job postings at the lowest cost on the market, pay only per result. Extract thousands of jobs with full details, filters, deduplication, and optional company enrichment. No login required.", "version": "1.0", "x-build-id": "MfCKmSm9wrHMm4GtG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/number_one_scraper~cheap-advance-linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-number_one_scraper-cheap-advance-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/number_one_scraper~cheap-advance-linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-number_one_scraper-cheap-advance-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/number_one_scraper~cheap-advance-linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-number_one_scraper-cheap-advance-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "One or more LinkedIn job search URLs to crawl. The Actor will scrape job listings from these pages and follow pagination.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keyword": { "title": "Keywords", "type": "array", "description": "Keywords to search for on LinkedIn Jobs (e.g., 'Software Engineer', 'Data Scientist'). Each keyword generates a separate search.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to search in (e.g., 'Montreal, Canada', 'New York, NY', 'London, UK'). LinkedIn will resolve this to a geographic area." }, "distance": { "title": "Distance (Search Radius)", "enum": [ "", "5", "10", "15", "25", "50" ], "type": "string", "description": "Search radius from the location in miles. Leave empty for LinkedIn's default.", "default": "" }, "publishedAt": { "title": "Published At", "enum": [ "", "r86400", "r604800", "r2592000" ], "type": "string", "description": "Filter by how recently the job was posted. Leave empty for any time.", "default": "" }, "jobType": { "title": "Job Type", "type": "array", "description": "Filter by job type. Multiple selections allowed.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "temporary", "internship" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship" ] } }, "experienceLevel": { "title": "Experience Level", "type": "array", "description": "Filter by experience level. Multiple selections allowed.", "items": { "type": "string", "enum": [ "internship", "entry-level", "associate", "mid-senior", "director" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director" ] } }, "workType": { "title": "Work Type", "type": "array", "description": "Filter by work location type. Multiple selections allowed.", "items": { "type": "string", "enum": [ "on-site", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "salaryBase": { "title": "Minimum Salary", "enum": [ "", "40000", "60000", "80000", "100000", "120000" ], "type": "string", "description": "Filter by minimum salary (USD). Only one value allowed.", "default": "" }, "maxItems": { "title": "Maximum Results", "minimum": 1, "type": "integer", "description": "Maximum number of job listings to scrape. Leave empty for default (500). Each keyword/URL can return up to 1,000 results.", "default": 500 }, "saveOnlyUniqueItems": { "title": "Save Only Unique Items", "type": "boolean", "description": "If enabled, duplicate job listings (same job ID) will be removed from results.", "default": false }, "cleanDescription": { "title": "Clean Description (Plain Text)", "type": "boolean", "description": "When enabled, job descriptions are returned as plain text instead of HTML. Useful if you don't need rich formatting.", "default": false }, "enrichCompanyData": { "title": "Enrich Company Data", "type": "boolean", "description": "When enabled, the scraper fetches additional company details including: company description, full address, employee count, and company website. Note: This makes the scraper significantly slower as it requires additional requests per company.", "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 } } }, "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 } } } } } } } } } }