{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Scraper With Growth Tracker", "description": "LinkedIn Company Employees Scraper extracts employee lists from LinkedIn company pages, including names, roles, locations, experience, and profile URLs. Ideal for recruiting, lead generation, market research, and automating structured employee data collection at scale", "version": "0.1", "x-build-id": "FmlCV5waESIhCt3C3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~linkedin-company-employees/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~linkedin-company-employees/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~linkedin-company-employees/run-sync": { "post": { "operationId": "run-sync-simpleapi-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 names to track", "minItems": 1, "type": "array", "description": "📋 One entry per line: full LinkedIn company URLs (e.g. https://www.linkedin.com/company/google) OR a plain company name/keyword for discovery. 🔁 Add the SAME entry to every scheduled run so its snapshots line up into one growth series. (Also accepts the base `urls` input key for backward compatibility.)", "items": { "type": "string" } }, "employeesPerSnapshot": { "title": "👥 Employees to sample per snapshot", "minimum": 1, "maximum": 10000, "type": "integer", "description": "🎯 How many employee profiles to discover and scrape per company for THIS snapshot (1–10,000). This is the sample size the headcount total and department breakdown are computed from — keep it consistent across scheduled runs so snapshots stay comparable. (Also accepts the base `max_employees` input key.) Default 10." }, "includeDepartmentBreakdown": { "title": "📊 Include department headcount breakdown", "type": "boolean", "description": "🧩 When ON, each snapshot includes a rule-based department breakdown (Engineering/Sales/Marketing/Product/Design/Finance/HR/Operations/Legal/Customer Success/IT/Data & Analytics/Executive/Consulting/Unclassified) — a headcount COUNT and a % share per bucket, classified from each scraped employee's public headline text. Turn OFF for a faster run that only logs the total headcount.", "default": true }, "snapshotLabel": { "title": "🏷️ Snapshot label (optional)", "type": "string", "description": "✍️ Optional free-text tag stamped onto this run's snapshot row (e.g. \"Q3-week1\"). Useful when you schedule repeat runs and want to identify a specific snapshot later in your own growth-over-time analysis. Leave empty to skip." }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "🏠 Recommended: Apify Residential for fewer blocks on the logged-out company/people-page scrape. 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 } } } } } } } } } }