{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Jobs Scraper", "description": "Scrape a LinkedIn company's live job postings: title, location, postedAt, apply URL + optional description, applicants, seniority, plus company metadata. MCP/API-ready.", "version": "0.1", "x-build-id": "kHFEBMfEf6Qu8rrz9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~linkedin-company-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-linkedin-company-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/khadinakbar~linkedin-company-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-linkedin-company-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/khadinakbar~linkedin-company-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-linkedin-company-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": [ "company" ], "properties": { "company": { "title": "Company (LinkedIn URL, slug, or numeric ID)", "type": "string", "description": "The LinkedIn company whose job postings you want. Accepts a company URL (e.g. 'https://www.linkedin.com/company/stripe'), a bare slug ('stripe'), or a numeric LinkedIn company ID ('51737071'). A URL or slug is resolved to the numeric ID via ScrapeCreators (primary) then SociaVault (fallback). NOT a job-search keyword and NOT a personal profile URL — for keyword job search use the linkedin-jobs-scraper actor." }, "keywords": { "title": "Job title keywords (optional)", "type": "string", "description": "Optional free-text filter applied to the company's postings (e.g. 'engineer', 'product manager'). Matches LinkedIn's job-title search. Leave empty to return all open roles at the company. This filters WITHIN one company, it does not search across companies." }, "location": { "title": "Location filter (optional)", "type": "string", "description": "Optional geographic filter such as 'United States', 'London', or 'Remote'. Maps to LinkedIn's job location facet. Leave empty for all locations. This is a job-location filter, not the company headquarters." }, "datePosted": { "title": "Date posted", "enum": [ "any", "month", "week", "day" ], "type": "string", "description": "Limit results by how recently a job was posted. 'any' returns all open postings; 'month'/'week'/'day' restrict to the last 30/7/1 days. Defaults to 'any'.", "default": "any" }, "jobType": { "title": "Employment type", "enum": [ "any", "full-time", "part-time", "contract", "temporary", "internship" ], "type": "string", "description": "Filter by employment type. 'any' returns all types. Maps to LinkedIn's job-type facet (F/P/C/T/I). Defaults to 'any'.", "default": "any" }, "experienceLevel": { "title": "Experience level", "enum": [ "any", "internship", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Filter by seniority. 'any' returns all levels. Maps to LinkedIn's experience facet. Defaults to 'any'.", "default": "any" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "When true, returns only roles LinkedIn flags as remote. Defaults to false (all workplace types: on-site, hybrid, remote).", "default": false }, "maxResults": { "title": "Max jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of job postings to return. LinkedIn's guest endpoint caps near 1000 per company-query. Defaults to 50. Each returned job is billed at the per-job rate.", "default": 50 }, "enrichJobDetails": { "title": "Fetch full job details", "type": "boolean", "description": "When true, visits each job's detail page to add description text, applicant count, seniority, employment type, job function and industries. Slower and adds one request per job. Defaults to false (list-level fields only).", "default": false }, "enrichCompany": { "title": "Attach company metadata", "type": "boolean", "description": "When true, attaches the company's industry, size, employee count, headquarters, followers, website and logo via ScrapeCreators/SociaVault. Required and forced on when 'company' is a URL or slug (used to resolve the numeric ID). Set false only when you pass a numeric company ID and want jobs without company metadata. Defaults to true.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Defaults to Apify Residential US, which LinkedIn's job endpoints require. Override only if you know what you are doing.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }