{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper – Keywords, Location & Filters", "description": "Scrape LinkedIn jobs by keyword, job title, location, company, date, experience level, employment type, and workplace type. Extract job titles, companies, locations, salaries, posting dates, applicant counts, full descriptions, and LinkedIn job URLs without login or cookies.", "version": "0.0", "x-build-id": "admZR2zhEL0LTSDUY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~linkedin-jobs-scraper-by-keyword/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-linkedin-jobs-scraper-by-keyword", "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/apt_marble~linkedin-jobs-scraper-by-keyword/runs": { "post": { "operationId": "runs-sync-apt_marble-linkedin-jobs-scraper-by-keyword", "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/apt_marble~linkedin-jobs-scraper-by-keyword/run-sync": { "post": { "operationId": "run-sync-apt_marble-linkedin-jobs-scraper-by-keyword", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms (keywords)", "type": "array", "description": "One or more job-title or keyword searches. Each term gets its own result quota.", "default": [ "data engineer" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Geographic location for the search, e.g. \"United States\", \"London, England, United Kingdom\" or \"Remote\". Applies to every search term.", "default": "United States" }, "maxJobsPerTerm": { "title": "Maximum jobs per search term", "minimum": 0, "type": "integer", "description": "How many jobs to scrape for each search term.", "default": 25 }, "scrapeJobDetails": { "title": "Scrape full job details 💎 (paid plans only)", "type": "boolean", "description": "💎 Premium feature — available on paid Apify plans only. Opens each job to capture the full description, seniority level, employment type, job function, industries and applicant count. Free-plan users can switch this on, but runs will fall back to list-level data (title, company, location, posted date, salary) with an upgrade notice in the log. Upgrade your Apify plan to enable it.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "How LinkedIn ranks the results.", "default": "relevance" }, "datePosted": { "title": "Date posted", "enum": [ "", "past24Hours", "pastWeek", "pastMonth" ], "type": "string", "description": "Only include jobs posted within this window.", "default": "" }, "experienceLevel": { "title": "Experience level", "type": "array", "description": "Restrict to one or more experience levels.", "items": { "type": "string", "enum": [ "internship", "entryLevel", "associate", "midSenior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] }, "default": [] }, "jobType": { "title": "Job type", "type": "array", "description": "Restrict to one or more employment types.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] }, "default": [] }, "workplaceType": { "title": "On-site / Remote / Hybrid", "type": "array", "description": "Restrict to one or more workplace arrangements.", "items": { "type": "string", "enum": [ "onSite", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] }, "default": [] }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Only include jobs that can be applied to with LinkedIn Easy Apply.", "default": false }, "geoId": { "title": "Geo ID (advanced)", "type": "string", "description": "LinkedIn's internal numeric location id. Optional — when set it overrides the Location text for more precise targeting (find it in a linkedin.com job-search URL as the geoId parameter).", "default": "" }, "companyIds": { "title": "Company IDs (advanced)", "type": "array", "description": "Restrict results to specific companies by their numeric LinkedIn company id.", "default": [], "items": { "type": "string" } }, "proxyCountry": { "title": "IP country (advanced)", "type": "string", "description": "Two-letter country code for the request IP. Leave as \"us\" unless you need the results served from a specific country.", "default": "us" }, "maxConcurrency": { "title": "Concurrency (advanced)", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search terms to process in parallel.", "default": 3 } } }, "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 } } } } } } } } } }