{ "openapi": "3.0.1", "info": { "title": "LinkedIn Search Jobs Scraper & Company Insights", "description": "Scrape LinkedIn job search results with company insights, including job titles, locations, employment types, posting dates, company names, industries, sizes, and URLs. Analyze hiring trends, research employers, identify prospects, and build targeted recruitment and B2B lead lists.", "version": "0.1", "x-build-id": "aw8Iv8tVZvyprnj3q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~linkedin-search-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-linkedin-search-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/scrapier~linkedin-search-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-linkedin-search-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/scrapier~linkedin-search-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-linkedin-search-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔗 Job Search / Company URLs / Keywords", "type": "array", "description": "Add LinkedIn job search URLs, keywords, a company profile URL (e.g. linkedin.com/company/notion), or structured inputs. Examples: 'software engineer, United States', 'https://www.linkedin.com/company/notion', a full job search URL, or a direct job URL/ID. Company URLs now correctly resolve to that company's real numeric ID for accurate results. One item per line.", "items": { "type": "string" } }, "sortOrder": { "title": "↕️ Sort Order", "enum": [ "relevant", "recent" ], "type": "string", "description": "Choose how to sort results: most relevant or most recent.", "default": "relevant" }, "maxJobs": { "title": "🔢 Max Jobs Per Input", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of jobs to scrape for each input (range: 1-10000). Note: real delivery is capped at roughly 1000 jobs per input by the search pagination depth.", "default": 10 }, "enrichCompanyProfile": { "title": "🏢 Enrich With Company Profile", "type": "boolean", "description": "Fetch each unique employer's own LinkedIn company page (industry, company size, headquarters, organization type, founded year, follower count, tagline, website, numeric org ID). One extra request per unique company per run, cached — not per job.", "default": true }, "extractSalaryInsights": { "title": "💰 Extract Salary & Requirements Insights", "type": "boolean", "description": "Fetch each job's structured data block for salary range (currency/min/max/period), absolute posted and expiry dates, employment type, job location with coordinates, months of experience, and education tier. Coverage is genuinely partial (LinkedIn does not publish structured salary on every posting) — fields are null when not available, never fabricated.", "default": true }, "proxyConfiguration": { "title": "🛡️ Proxy Configuration (Optional)", "type": "object", "description": "Optional: Enable Apify proxy if needed. By default, the actor runs with direct requests (no proxy). Turn proxy on only if requests get blocked. Note: proxies may consume extra credits." } } }, "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 } } } } } } } } } }