{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Scraper – Posts & Followers", "description": "Scrape any public LinkedIn company page: follower count, tagline, full description, logo, website, industry, size, headquarters, address and founding year, plus its latest posts with text, publish time, reactions and comments. No login, no API key — one request a company. Unofficial.", "version": "0.1", "x-build-id": "UVXaoyTUDKeiP4d4j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simple.actors~linkedin-company-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simple.actors-linkedin-company-posts", "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/simple.actors~linkedin-company-posts/runs": { "post": { "operationId": "runs-sync-simple.actors-linkedin-company-posts", "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/simple.actors~linkedin-company-posts/run-sync": { "post": { "operationId": "run-sync-simple.actors-linkedin-company-posts", "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": { "startUrls": { "title": "LinkedIn company URLs", "type": "array", "description": "Public LinkedIn company pages, e.g. https://www.linkedin.com/company/dishoom. Locale hosts (uk.linkedin.com), sub-pages (/about/) and /school/ pages all work and are normalised for you. Personal profiles (/in/…) cannot be read — LinkedIn serves those only behind a login — and come back as a row saying so rather than failing the run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "companies": { "title": "Company slugs (no URL needed)", "type": "array", "description": "The slug on its own — \"dishoom\", \"vercel\", \"stripe\" — which is easier to paste as a column out of a spreadsheet. The slug is the part after /company/ in the address bar, and it is often not the brand name.", "items": { "type": "string" } }, "outputFormat": { "title": "Row shape: one per post, or one per company", "enum": [ "posts", "company" ], "type": "string", "description": "**One row per post** (default) gives every post its own row with the company record repeated on each — the shape to pipe into a warehouse. **One row per company** gives each company a single row with its posts nested under `posts`, which is the one to pick when you are looking at companies rather than collecting posts. Same price either way.\n\nA company that was read but has posted nothing in your window always comes back as a company row, so it can never be confused with one that was not read.", "default": "posts" }, "maxPosts": { "title": "Posts per company (max 12)", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many of the latest posts to return per company, newest first. A LinkedIn company page renders roughly 9 to 11 posts to a logged-out reader and offers no way to page further without a login, so 12 is the ceiling rather than a target. Lowering it does not make the run cheaper — the charge is per company.", "default": 12 }, "onlyPostsNewerThan": { "title": "Only posts newer than (window or ISO date)", "type": "string", "description": "Keep only posts published after this point — ideal for incremental polling. Takes an ISO date like 2026-08-01, or a window like \"3 days\", \"12 hours\", \"last 2 weeks\". Because a run reads one page, a window reaching further back than that page shows returns an error row for that company (window_too_wide) rather than a short list that would read as a complete answer. The run itself still succeeds." }, "proxy": { "title": "Proxy (datacenter is enough)", "type": "object", "description": "Defaults to Apify's datacenter proxy, which is what this Actor is built and measured on: 16 of 16 valid company pages answered over datacenter, and LinkedIn's occasional 999 refusal is random per request rather than tied to the company, so a retry on a fresh address clears it. Switch to residential only if companies start coming back as read failures.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }