{
"openapi": "3.0.1",
"info": {
"title": "LinkedIn Company Enrichment — B2B Data & Firmographics API",
"description": "Extract LinkedIn company profiles and firmographics (industry, size, HQ, locations, followers, recent posts), with optional AI enrichment. B2B data for lead scoring, TAM sizing and CRM hygiene. No login or cookies needed.",
"version": "1.0",
"x-build-id": "naYUhXX8E90JYOMXy"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zhorex~linkedin-company-enrichment/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zhorex-linkedin-company-enrichment",
"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/zhorex~linkedin-company-enrichment/runs": {
"post": {
"operationId": "runs-sync-zhorex-linkedin-company-enrichment",
"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/zhorex~linkedin-company-enrichment/run-sync": {
"post": {
"operationId": "run-sync-zhorex-linkedin-company-enrichment",
"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 LinkedIn URLs",
"type": "array",
"description": "LinkedIn company page URLs to enrich. E.g. https://linkedin.com/company/stripe",
"items": {
"type": "string"
}
},
"companyNames": {
"title": "Company Names (search)",
"type": "array",
"description": "Company names to search on LinkedIn. Currently NOT working: a names-only run returns no companies (and still pays the run start). Pass companyUrls instead.",
"items": {
"type": "string"
}
},
"extractEmployees": {
"title": "Try to Extract Key Employees (needs a logged-in session)",
"type": "boolean",
"description": "Try to extract key employees (C-suite, VPs, Directors) from the company's /people/ tab. Read this before turning it on: LinkedIn serves that tab only to a logged-in session and returns HTTP 999 to everyone else, so on an anonymous run key_people comes back empty and you are billed the ordinary company rate, not the $0.015 company-with-employees rate. Every company-level field (firmographics, follower count, recent posts, locations) is unaffected and always populated. Off by default so your first run is not full of empty people arrays.",
"default": false
},
"employeeSeniority": {
"title": "Employee Seniority Filter",
"type": "array",
"description": "Which seniority levels to extract.",
"items": {
"type": "string",
"enum": [
"c_suite",
"vp",
"director",
"head_of",
"manager"
],
"enumTitles": [
"C-Suite (CEO, CTO, CFO...)",
"Vice President",
"Director",
"Head of Department",
"Manager"
]
},
"default": [
"c_suite",
"vp",
"director"
]
},
"employeeDepartments": {
"title": "Employee Department Filter",
"type": "array",
"description": "Filter employees by department. Leave empty for all departments.",
"items": {
"type": "string",
"enum": [
"engineering",
"sales",
"marketing",
"hr",
"finance",
"product",
"operations",
"legal"
],
"enumTitles": [
"Engineering",
"Sales",
"Marketing",
"Human Resources",
"Finance",
"Product",
"Operations",
"Legal"
]
}
},
"maxEmployeesPerCompany": {
"title": "Max Employees per Company",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Maximum number of key employees to extract per company.",
"default": 10
},
"enableAiEnrichment": {
"title": "Enable AI Enrichment (Claude API)",
"type": "boolean",
"description": "Use Claude AI to generate ICP scores, competitive landscape, growth assessment, and outreach angles. Requires Anthropic API key. Billing: a company where Claude returns a result is charged company-ai-enriched ($0.035) on top of the $0.008 company record (instead of the $0.015 employees add-on), and the Anthropic API key is yours, so you also pay Claude for the tokens.",
"default": false
},
"icpDescription": {
"title": "Ideal Customer Profile",
"type": "string",
"description": "Describe your ideal customer for AI-powered ICP scoring. E.g. 'B2B SaaS companies with 50-500 employees in the US that use cloud infrastructure'."
},
"anthropicApiKey": {
"title": "Anthropic API Key",
"type": "string",
"description": "Your Anthropic API key for AI enrichment features. Get one at console.anthropic.com."
},
"maxResults": {
"title": "Max Companies",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Maximum number of companies to process in a single run.",
"default": 20
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. Residential proxies are strongly recommended for LinkedIn."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}