{ "openapi": "3.0.1", "info": { "title": "LinkedIn Employees Scraper", "description": "List the employees LinkedIn features on public company pages, without login or cookies. Input: company URLs or slugs. Output: one item per featured employee with fullName, profileUrl, location, photo and companyName; title only when publicly visible. Typically 1-4 people per company.", "version": "1.0", "x-build-id": "yPyPkmkFkZjioDON3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/artificially~linkedin-employees-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-artificially-linkedin-employees-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/artificially~linkedin-employees-scraper/runs": { "post": { "operationId": "runs-sync-artificially-linkedin-employees-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/artificially~linkedin-employees-scraper/run-sync": { "post": { "operationId": "run-sync-artificially-linkedin-employees-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": { "companyUrls": { "title": "Company URLs", "type": "array", "description": "LinkedIn company page URLs whose employees to list, one per line, e.g. \"https://www.linkedin.com/company/stripe\". Provide this and/or companyIds; at least one company is required.", "items": { "type": "string" } }, "companyIds": { "title": "Company IDs", "type": "array", "description": "LinkedIn company slugs (the part after /company/ in the URL), one per line, e.g. \"stripe\". Use instead of or together with companyUrls; duplicates are removed.", "items": { "type": "string" } }, "maxEmployees": { "title": "Maximum Employees per Company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of employees to save per company. Integer 1-100, e.g. 10. Without login only the employees LinkedIn features on the public company page are available, typically fewer than 20 per company.", "default": 50 }, "scrapeFullProfiles": { "title": "Scrape Full Profiles", "type": "boolean", "description": "If true, open each employee's public profile to get their current headline and location (slower, one extra request per employee). If false, return only the name, title and photo shown on the company page (fast).", "default": true }, "maxAttempts": { "title": "Max attempts per page", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many times to retry a company or profile page that is blocked or shows LinkedIn's login wall, each attempt on a fresh proxy IP. Integer 1-15, e.g. 4. Pages that still fail are never saved or charged.", "default": 4 }, "residentialFallback": { "title": "Residential proxy fallback", "type": "boolean", "description": "If true, after half of the attempts fail on the selected proxy, the remaining attempts go through Apify residential proxies, which LinkedIn blocks far less often. Only applies on the Apify platform. Recommended: true.", "default": true }, "compactOutput": { "title": "Compact output (for AI agents)", "type": "boolean", "description": "If true, save a slimmer item per employee with only: profileUrl, username, fullName, title, location, companyName, companyId. Drops the photo URL, company URL, connectionDegree and scrapedAt. Recommended for AI agents and LLM pipelines. Default false keeps the full item.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Proxy is strongly recommended because LinkedIn blocks most unproxied traffic. Leave the default {\"useApifyProxy\": true} unless you have your own proxies." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }