{ "openapi": "3.0.1", "info": { "title": "Linkedin Jobs Scraper", "description": "Scrape LinkedIn Jobs effortlessly with this extremely fast and intuitive Scraper. Retrieve structured data as job titles, companies, locations, employment type, and detailed descriptions.", "version": "1.0", "x-build-id": "dNQBFNBd8Xwf5MvQZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alvaraaz~linkedin-jobs-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alvaraaz-linkedin-jobs-actor", "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/alvaraaz~linkedin-jobs-actor/runs": { "post": { "operationId": "runs-sync-alvaraaz-linkedin-jobs-actor", "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/alvaraaz~linkedin-jobs-actor/run-sync": { "post": { "operationId": "run-sync-alvaraaz-linkedin-jobs-actor", "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", "required": [ "keywords", "location" ], "properties": { "keywords": { "title": "Job Keywords", "type": "string", "description": "Job title, skills, or keywords to search for. Separate multiple keywords with commas (e.g., 'python developer, data scientist'). This is the main search term used to find relevant job listings on LinkedIn." }, "location": { "title": "Location", "type": "string", "description": "City, region, or country to search for jobs. Enter a city name (e.g., 'Madrid'), a country name (e.g., 'Spain'), or a combination (e.g., 'Barcelona, Spain')." }, "workModel": { "title": "Work Model", "enum": [ "", "remote", "hybrid", "onsite" ], "type": "string", "description": "Filter jobs by work arrangement type", "default": "" }, "jobType": { "title": "Job Type", "enum": [ "", "full-time", "part-time", "contract", "temporary", "volunteer", "internship" ], "type": "string", "description": "Filter jobs by employment type", "default": "" }, "experienceLevel": { "title": "Experience Level", "enum": [ "", "internship", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Filter jobs by experience level", "default": "" }, "timePosted": { "title": "Time Posted", "enum": [ "", "past_24_hours", "past_week", "past_month" ], "type": "string", "description": "Filter jobs by when they were posted", "default": "" }, "salary": { "title": "Minimum Salary", "enum": [ "", "40k", "60k", "80k", "100k", "120k", "140k", "160k", "180k", "200k" ], "type": "string", "description": "Filter jobs by minimum salary (USD). Only works for locations with salary data (e.g., United States). For other locations, this filter is ignored by LinkedIn.", "default": "" }, "companyId": { "title": "Company ID", "type": "string", "description": "Filter jobs by company ID. Enter the LinkedIn company ID (found in company URL like /company/123456/). Leave empty for all companies." }, "jobsNumber": { "title": "Maximum Jobs to Scrape", "minimum": 20, "type": "integer", "description": "Maximum number of job listings to collect. The scraper will stop once it reaches this limit. Minimum is 20 jobs. Higher numbers mean longer execution time. Default is 200 jobs.", "default": 200 } } }, "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 } } } } } } } } } }