{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees : Org & Department Analytics Scraper", "description": "Extract employee data from LinkedIn companies with the LinkedIn Company Employees Scraper. Retrieve names, job titles, positions, and profiles of employees. Perfect for recruitment, lead generation, and organizational research. Fast, accurate, and scalable for any company.", "version": "0.1", "x-build-id": "WzLmy8AJbvA6FIxca" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~linkedin-company-employees/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-linkedin-company-employees", "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/scrapier~linkedin-company-employees/runs": { "post": { "operationId": "runs-sync-scrapier-linkedin-company-employees", "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/scrapier~linkedin-company-employees/run-sync": { "post": { "operationId": "run-sync-scrapier-linkedin-company-employees", "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": { "companyTargets": { "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 keywords/company names for discovery. Also accepts the base actor's `urls` input key for backward compatibility.", "items": { "type": "string" } }, "employeesPerCompany": { "title": "🧭 Employees to map per company", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many employee profiles to discover, scrape, and classify per company/keyword (1–10,000). Also accepts the base actor's `max_employees` input key." }, "includeCareerHistory": { "title": "🎓 Harvest career history (experience, education & skills)", "type": "boolean", "description": "When ON, parses each profile's already-fetched page for its full work-experience history, education history, and skills list — zero extra requests. Default ON.", "default": true }, "includeOrgRollup": { "title": "📊 Add org-composition roll-up row", "type": "boolean", "description": "When ON, after scraping each company's employees, pushes ONE extra summary row (type=org_summary) with seniority-tier counts, department counts, and decision-maker % for that company. Always computed over ALL scraped profiles, even if a seniority/department/decision-maker filter below is set. Default ON.", "default": true }, "senioritiesToInclude": { "title": "🎚️ Seniority tiers to include (optional filter)", "type": "array", "description": "Leave empty to keep every employee row (default — matches base behavior). When set, only rows whose rule-based seniorityLevel matches one of the selected tiers are pushed to the dataset (the org roll-up row is unaffected).", "items": { "type": "string", "enum": [ "Owner", "Partner", "CXO", "Vice President", "Director", "Experienced Manager", "Entry Manager", "Senior", "Entry", "In Training" ], "enumTitles": [ "Owner", "Partner", "CXO (Chief/Founder)", "Vice President", "Director", "Experienced Manager", "Entry Manager", "Senior (individual contributor)", "Entry (individual contributor)", "In Training (intern/trainee)" ] }, "default": [] }, "departmentsToInclude": { "title": "🏢 Departments to include (optional filter)", "type": "array", "description": "Leave empty to keep every employee row (default — matches base behavior). When set, only rows whose rule-based department matches one of the selected buckets are pushed to the dataset.", "items": { "type": "string", "enum": [ "Engineering", "Sales", "Marketing", "HR", "Finance", "Operations", "Product", "Design", "Legal", "Support" ], "enumTitles": [ "Engineering", "Sales", "Marketing", "HR / People", "Finance", "Operations", "Product", "Design", "Legal", "Support / Customer Success" ] }, "default": [] }, "decisionMakersOnly": { "title": "✅ Decision-makers only", "type": "boolean", "description": "When ON, only pushes employees classified as Owner/Partner/CXO/Vice President/Director (isDecisionMaker=true). Default OFF (keeps every employee row, matching base behavior).", "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 turned 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 } } } } } } } } } }