{ "openapi": "3.0.1", "info": { "title": "Linkedin Jobs Search", "description": "Scrape LinkedIn job search result (including company details)", "version": "0.0", "x-build-id": "nzwPOYL9jJcbAhMvP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benjarapi~linkedin-jobs-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benjarapi-linkedin-jobs-search", "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/benjarapi~linkedin-jobs-search/runs": { "post": { "operationId": "runs-sync-benjarapi-linkedin-jobs-search", "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/benjarapi~linkedin-jobs-search/run-sync": { "post": { "operationId": "run-sync-benjarapi-linkedin-jobs-search", "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": { "keywords": { "title": "Search keywords", "type": "string", "description": "Keywords to search LinkedIn jobs (e.g. \"Software Engineer\", \"Product Manager\"). Ignored when a Search URL is provided." }, "searchUrl": { "title": "LinkedIn jobs search URL", "type": "string", "description": "Full LinkedIn jobs search URL (https://www.linkedin.com/jobs/search/?...). If provided, keywords, location, geoId and all filters are extracted from it, overriding the manual inputs below." }, "location": { "title": "Location (text)", "type": "string", "description": "Location name, e.g. \"United States\", \"Berlin, Germany\". Use either this or Geo ID." }, "geoId": { "title": "Geo ID", "type": "string", "description": "Numeric LinkedIn geo id (e.g. 103644278 for the United States). Takes precedence over the text location. Find it in a LinkedIn jobs search URL's geoId parameter." }, "maxJobs": { "title": "Maximum jobs to collect", "minimum": 1, "type": "integer", "description": "Maximum number of jobs to collect. The LinkedIn guest API exposes at most ~1000 results per query, so values above 1000 are capped." }, "scrapeDetails": { "title": "Scrape job details", "type": "boolean", "description": "Fetch each job's detail page to enrich it with full description, job criteria (seniority, employment type, function, industries), applicant count, apply type, company URL, and the job poster (recruiter). Adds one request per job.", "default": true }, "scrapeCompany": { "title": "Scrape company details", "type": "boolean", "description": "Enrich each job with its company's website, description, slogan, employee count, and address (from the company's public page). Companies are fetched once and reused across jobs. Requires 'Scrape job details'.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of requests to run in parallel (1-20). Higher is faster; each request uses a rotating proxy IP to avoid rate limits.", "default": 10 }, "datePosted": { "title": "Date posted", "enum": [ "", "r86400", "r604800", "r2592000" ], "type": "string", "description": "Restrict to jobs posted within this window.", "default": "" }, "jobType": { "title": "Job type", "type": "array", "description": "Employment type(s) to include.", "items": { "type": "string", "enum": [ "F", "P", "C", "T", "I", "V", "O" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] } }, "experienceLevel": { "title": "Experience level", "type": "array", "description": "Experience level(s) to include.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "workplaceType": { "title": "Workplace type", "type": "array", "description": "On-site, remote, or hybrid.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "companyId": { "title": "Company IDs", "type": "array", "description": "Restrict to specific LinkedIn company id(s) (the numeric f_C facet value).", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "", "R", "DD" ], "type": "string", "description": "Result ordering.", "default": "" }, "distance": { "title": "Distance (miles)", "minimum": 0, "type": "integer", "description": "Search radius in miles around the location." }, "maxTimeoutMs": { "title": "Per-request timeout (ms)", "minimum": 3000, "type": "integer", "description": "How long to wait for a single guest request before aborting and retrying on a fresh proxy IP. Lower values fail bad IPs faster (the guest endpoints normally answer in under 2s); raise it only if your proxy has high latency.", "default": 12000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for the guest requests. Residential proxies are strongly recommended — the guest API is IP rate-limited." } } }, "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 } } } } } } } } } }