{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Scraper : Public Contact Info", "description": "Extract company employee data from LinkedIn at scale. Get names, job titles, departments, and locations with clean structured output for HR teams, recruiters, and analysts.", "version": "0.1", "x-build-id": "zRyhvX1xpszKbRIBE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~linkedin-company-employees-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-linkedin-company-employees-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/scrapio~linkedin-company-employees-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-linkedin-company-employees-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/scrapio~linkedin-company-employees-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-linkedin-company-employees-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": { "companyUrlsOrKeywords": { "title": "🏢 Company URLs or search keywords", "minItems": 1, "type": "array", "description": "One entry per line: full LinkedIn company URLs (e.g. https://www.linkedin.com/company/google) OR plain company names for discovery. Bulk-friendly — queue many companies in one run. (Also accepts the base actor's `urls` key for backward compatibility.)", "items": { "type": "string" } }, "maxContactsPerCompany": { "title": "👥 Max contact cards per company", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap how many employee contact cards to discover and build per company (1–10,000). Higher = more leads & longer runs. (Also accepts the base actor's `max_employees` key.)" }, "includePublicContactLinks": { "title": "🔗 Extract public contact / social links", "type": "boolean", "description": "When ON, scans each already-fetched public profile page for genuinely displayed external links (personal website, Twitter/X, GitHub, YouTube, etc.) and returns them in `publicContactLinks`. Never guessed or pattern-matched — `null`/empty when the profile shows none. Default ON.", "default": true }, "includeCrmContactCard": { "title": "📇 Build CRM-ready contact card", "type": "boolean", "description": "When ON, adds a normalized `crmContactCard` object (full name, job title, company, direct profile URL, best public link) to every row — a ready-to-import outreach record built 100% from already-scraped fields, no fabricated data. Default ON.", "default": true }, "onlyWithContactLink": { "title": "🎯 Only keep contacts with a public link", "type": "boolean", "description": "When ON, rows for profiles with NO public contact/social link found are skipped entirely (not pushed to the dataset). Useful for CRM imports where you only want directly reachable contacts. Default OFF (keep every discovered profile).", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Recommended: Apify Residential for fewer blocks. If Apify proxy is ON, these settings are used. If you turn it OFF, requests go direct (higher block risk). If omitted, default residential (US) is used." } } }, "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 } } } } } } } } } }