{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Scraper", "description": "LinkedIn Company Scraper extracts detailed data from any public LinkedIn company page. Collect overview info, employees, locations, posts, specialties, and growth signals. Ideal for market research, lead generation, competitor analysis, and automated B2B data workflows.", "version": "0.2", "x-build-id": "Xs6VidUAEO1vFoIgZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~linkedin-company-scraper-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-linkedin-company-scraper-actor", "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/api-empire~linkedin-company-scraper-actor/runs": { "post": { "operationId": "runs-sync-api-empire-linkedin-company-scraper-actor", "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/api-empire~linkedin-company-scraper-actor/run-sync": { "post": { "operationId": "run-sync-api-empire-linkedin-company-scraper-actor", "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": [ "urls" ], "properties": { "urls": { "title": "🔗 Company URLs or vanity names", "minItems": 1, "type": "array", "description": "Public LinkedIn company pages — a full URL (https://www.linkedin.com/company/stripe/) or a bare vanity/slug (stripe). One per line. Note: numeric company IDs are NOT accepted — LinkedIn redirects numeric-id URLs to the login authwall when logged out, so only the vanity slug reaches the public page. Example: [\"stripe\", \"https://www.linkedin.com/company/netflix/\"].", "items": { "type": "string" } }, "maxItems": { "title": "🔢 Max companies", "minimum": 0, "type": "integer", "description": "Cap on how many top-level companies to scrape from the list. 0 = no cap (scrape all provided). Example: maxItems=5 processes only the first 5. Default 0.", "default": 0 }, "includePosts": { "title": "📣 Include recent posts", "type": "boolean", "description": "Collect the recent public posts sample (from JSON-LD). Default true.", "default": true }, "includeEmployees": { "title": "👤 Include employees sample", "type": "boolean", "description": "Collect the public 'people at company' sample. Availability varies by company. Default true.", "default": true }, "includeSimilar": { "title": "🤝 Include similar pages", "type": "boolean", "description": "Collect the 'similar pages' companies sample. Default true.", "default": true }, "maxPerChild": { "title": "📊 Max per child list", "minimum": 0, "type": "integer", "description": "Upper bound on each child list (posts / employees / similar pages) per company. Example: maxPerChild=5 → up to 5 of each. Default 10.", "default": 10 }, "maxRetries": { "title": "🔁 Max attempts per company", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many times to try a company before giving up (each retry escalates to Apify Residential on a fresh IP if soft-blocked). Default 3.", "default": 3 }, "requestTimeoutSec": { "title": "⏱️ Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request HTTP timeout. Default 30.", "default": 30 }, "concurrency": { "title": "⚡ Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many companies to fetch in parallel. Default 3.", "default": 3 }, "proxy": { "title": "🌐 Proxy", "type": "object", "description": "Residential proxy strongly recommended for LinkedIn. If left off, the actor starts direct and auto-escalates to Apify Residential on the first soft-block. Chrome-131 TLS impersonation is always used.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }