{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Scraper - Employees, Followers & Posts", "description": "Scrape LinkedIn company pages by URL, name, website domain or ID: followers, employee count, size, industry, HQ and every office address, website, specialties, latest posts with engagement, similar companies and open jobs. No login or cookies. $2 per 1,000 companies.", "version": "0.1", "x-build-id": "89wBiSDPjfcHdSEae" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~linkedin-company-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-linkedin-company-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/eiv~linkedin-company-scraper/runs": { "post": { "operationId": "runs-sync-eiv-linkedin-company-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/eiv~linkedin-company-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-linkedin-company-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": { "targets": { "title": "Companies", "type": "array", "description": "One per line, in any of these forms: a LinkedIn company or showcase page URL (linkedin.com/company/stripe), a vanity name (stripe), a company name (Stripe), a website domain (stripe.com: the Actor finds the LinkedIn page the website links to) or a LinkedIn company id (2135371). Names and domains take one or two extra lookups; only the company itself is charged.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (for chaining Actors)", "type": "array", "description": "The same companies in the URL-list shape other Actors output, so a previous Actor's results (for example LinkedIn job or company URLs) can be fed straight in. Use this or the field above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max companies", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many companies in total, including similar companies when that option is on. You pay per company, so this is also your cost cap for the run.", "default": 10000 }, "maxPostsPerCompany": { "title": "Latest posts per company", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many of the company's latest posts to include, with text, date, reactions, comments and media type. LinkedIn shows logged-out visitors up to 10. Free: they come with the company page. The posting-rate and engagement fields always use every post shown. 0 leaves the posts out.", "default": 5 }, "includeEmployees": { "title": "Include employee previews", "type": "boolean", "description": "Add the few employees LinkedIn shows on the company page (name, headline, profile URL). Free: same page. Off by default because it is personal data; turn it on only if you have a lawful reason to process it.", "default": false }, "includeJobCount": { "title": "Include open jobs count", "type": "boolean", "description": "Add how many jobs the company has open on LinkedIn (a hiring signal), from LinkedIn's public job search. One extra request per company, no extra charge. LinkedIn shows exact counts up to its display cap, then e.g. \"2,000+\".", "default": false }, "expandSimilarCompanies": { "title": "Also scrape similar companies", "type": "boolean", "description": "After your companies, also scrape the companies LinkedIn lists under \"Similar pages\" on each of them (up to 10 each, one level deep): a quick way to grow a list of competitors or lookalike leads. Each one is a normal charged result; \"Max companies\" caps the total.", "default": false }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many companies are fetched at the same time. The Actor spreads requests over several addresses and slows down by itself when LinkedIn rate-limits, so the default rarely needs changing.", "default": 6 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one response before giving up on it.", "default": 30 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for dropped connections and server errors on one address. Refusals from LinkedIn move to another address instead. Timeouts are not retried.", "default": 2 } } }, "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 } } } } } } } } } }