{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper - Professional Job Listings", "description": "Scrapes public job listings from LinkedIn's job board. Filter by location, job type, experience level, and remote options. Extract company info, job descriptions, and application links. No login required.", "version": "3.0", "x-build-id": "tzSgjC4e1MFaKLcfW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~linkedin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-linkedin-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/santamaria-automations~linkedin-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-linkedin-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/santamaria-automations~linkedin-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-linkedin-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 (LinkedIn search URLs)", "type": "array", "description": "Paste LinkedIn job search URLs directly from your browser. The actor paginates from each URL and extracts all matching jobs. Example: https://www.linkedin.com/jobs/search/?keywords=Engineer&location=Germany", "items": { "type": "string" } }, "directUrls": { "title": "Direct Job URLs", "type": "array", "description": "List of LinkedIn job URLs to check directly (skips search). Use this for 'still alive' checks or re-scraping specific jobs. Example: https://www.linkedin.com/jobs/view/1234567890", "items": { "type": "string" } }, "searchQueries": { "title": "Search Keywords", "type": "array", "description": "One or more search keywords. Each keyword runs as a separate search. Results are deduplicated across queries.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query (single, legacy)", "type": "string", "description": "Single search keyword (backward compatible). Use 'searchQueries' for multiple keywords.", "default": "" }, "location": { "title": "Location", "type": "string", "description": "City, region, or country to search in (e.g., 'Zurich', 'Switzerland', 'San Francisco Bay Area')", "default": "" }, "country": { "title": "Country", "type": "string", "description": "Alternative to location - specify just the country (e.g., 'Switzerland', 'Germany', 'United States')", "default": "" }, "datePosted": { "title": "Date Posted", "enum": [ "any", "past-24h", "past-week", "past-month" ], "type": "string", "description": "Filter by when the job was posted", "default": "any" }, "sortBy": { "title": "Sort Order", "enum": [ "", "DD", "R" ], "type": "string", "description": "Sort search results by relevance or date", "default": "" }, "jobType": { "title": "Job Type", "enum": [ "", "full-time", "part-time", "contract", "temporary", "internship" ], "type": "string", "description": "Filter by employment type", "default": "" }, "experienceLevel": { "title": "Experience Level", "enum": [ "", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Filter by required experience level", "default": "" }, "remoteFilter": { "title": "Remote/On-site", "enum": [ "", "remote", "on-site", "hybrid" ], "type": "string", "description": "Filter by workplace type", "default": "" }, "maxResultsPerQuery": { "title": "Max Results per Query", "minimum": 1, "type": "integer", "description": "Per-keyword cap. Total possible results = maxResultsPerQuery × number of searchQueries (deduplicated). Example: 100 × 8 queries = up to 800 results.", "default": 100 }, "maxResults": { "title": "Max Total Results", "minimum": 0, "type": "integer", "description": "Total cap across all queries. Set to 0 for unlimited (each query limited by maxResultsPerQuery).", "default": 0 }, "easyApply": { "title": "Easy Apply Only", "type": "boolean", "description": "Filter for jobs with LinkedIn's Easy Apply feature (one-click apply without leaving LinkedIn).", "default": false }, "includeJobDetails": { "title": "Include Job Details (slower, richer)", "type": "boolean", "description": "OFF by default so first-time runs complete in under a minute. Turn ON to fetch each job's detail page and add the full description, employment type, seniority level, industry, company website, employee count, hiring manager name/title/profile, and more. Adds roughly 1 HTTP request per job (~2-4× slower).", "default": false }, "includeCompanyDetails": { "title": "Include Company Details (slower, richer)", "type": "boolean", "description": "OFF by default. Turn ON to enrich each job with the employer's company profile: type, founded year, headquarters, follower count, specialties, funding rounds, featured employees, and latest company updates. One HTTP request per unique company (deduplicated across the run). Requires Include Job Details to also be ON.", "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 } } } } } } } } } }