{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Scraper — Employee Count & Headcount Growth", "description": "LinkedIn company scraper: employee count (headcount), industry, HQ, website, founding year and followers from public company pages - keep the series to see how each company grows. Optional open jobs count and hiring signals. Company info in bulk. Failed or empty runs cost $0. No login, no cookies.", "version": "0.1", "x-build-id": "PP5IbMMcqkBUkcThi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~linkedin-company-growth-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-linkedin-company-growth-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/northbell~linkedin-company-growth-scraper/runs": { "post": { "operationId": "runs-sync-northbell-linkedin-company-growth-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/northbell~linkedin-company-growth-scraper/run-sync": { "post": { "operationId": "run-sync-northbell-linkedin-company-growth-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": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "Company websites (stripe.com), LinkedIn URLs or handles (stripe), or company names (Scale AI). Websites are matched to the LinkedIn page whose own website is that domain; every row says how it was matched.", "items": { "type": "string" } }, "similarPerCompany": { "title": "Also track similar companies (per company)", "minimum": 0, "maximum": 10, "type": "integer", "description": "For each company you list, also record the first N companies LinkedIn shows as similar on its page (up to 10) — a whole competitor set from one name. Each added company is a normal row with similarTo set, charged like any other company. 0 = only the companies you list.", "default": 0 }, "lookUpNames": { "title": "Look up company names on Wikidata", "type": "boolean", "description": "For plain company names (Scale AI, McDonald's, anthropic), also look the name up on Wikidata, which records many companies' LinkedIn page and official website. A page is used only when its website matches the one Wikidata lists. Adds about 4 seconds per name the first time (answers are remembered for 30 days). Turn off if your list is only LinkedIn URLs, handles and websites.", "default": true }, "onlyConfidentMatches": { "title": "Only confident matches", "type": "boolean", "description": "Every row says how the company was found (resolvedBy) and how sure that is (matchConfidence: high, medium or low). Turn this on to skip low matches: a page whose name and website both differ from what you entered is not returned as the company and not charged; you get a free unconfirmed row instead. Off: low matches are returned with their data, marked low, and not charged.", "default": false }, "includeOpenJobs": { "title": "Add open jobs count", "type": "boolean", "description": "Adds each company's number of open jobs on LinkedIn (worldwide) and the change since your last run. One more LinkedIn request per company, so a run takes about twice as long. No extra charge.", "default": false }, "archiveBackfill": { "title": "Growth on the first run (Web archive)", "type": "boolean", "description": "For a company you have not tracked before, reads the newest Internet Archive (Wayback Machine) copy of its LinkedIn page that is 60 days to a year old, so growth is filled on the first run. The row says the date and links the copy. Up to 30 companies per run, two archive requests each. No extra charge.", "default": true }, "minChangePercent": { "title": "Only companies that moved (minimum change, %)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Leave empty to get every company. Set for example 5 to return only companies whose employee count (or open jobs, when added) moved by 5% or more since your last run; companies seen for the first time always come back. The others are checked and added to your history but not charged, and named in one free notice row." }, "maxRequestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 60, "type": "integer", "description": "One request per company. Kept polite by default. The budget is shared across your runs of this Actor, so parallel runs do not stack up.", "default": 20 } } }, "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 } } } } } } } } } }