{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Scraper: Work History & Job Tenure", "description": "LinkedIn Company Employees Scraper: Work History & Job Tenure extracts employee profiles from LinkedIn company pages. It collects names, job titles, profile URLs, locations, and profile details. Ideal for lead generation, recruitment research, B2B prospecting, and company workforce analysis.", "version": "0.1", "x-build-id": "aB3g9K01DBJzlDFhh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperforge~linkedin-company-employees-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperforge-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/scraperforge~linkedin-company-employees-scraper/runs": { "post": { "operationId": "runs-sync-scraperforge-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/scraperforge~linkedin-company-employees-scraper/run-sync": { "post": { "operationId": "run-sync-scraperforge-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", "required": [ "urls" ], "properties": { "urls": { "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. ๐Ÿงฉ Bulk-friendly โ€” run many companies in one go!", "items": { "type": "string" } }, "max_employees": { "title": "๐Ÿ‘ฅ Max employees per company", "minimum": 1, "maximum": 10000, "type": "integer", "description": "๐ŸŽฏ Cap how many employee profiles to discover and scrape for each URL/keyword (1โ€“10,000). โฌ†๏ธ Higher = more data & longer runs.", "default": 10 }, "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 the block is omitted, default residential (US) is used." }, "include_work_history": { "title": "๐Ÿ•ฐ๏ธ Include work history", "type": "boolean", "description": "๐Ÿ“œ Pull every job LinkedIn shows on the public profile โ€” company, role, location, start and end dates โ€” into a `work_history` list, plus the current role's start date and tenure text. โš ๏ธ LinkedIn masks older roles on roughly two out of three public profiles; masked entries are returned with `is_masked: true` instead of being silently dropped.", "default": true }, "min_years_in_current_role": { "title": "โณ Minimum years in current role", "minimum": 0, "maximum": 50, "type": "integer", "description": "๐ŸŽฏ Keep only people who have been in their current job at least this many years, counted from the start date printed on their profile. 0 keeps everyone. โ„น๏ธ People whose start date LinkedIn hides are always kept โ€” set `only_full_work_history` to true if you want them dropped instead.", "default": 0 }, "past_employer_keywords": { "title": "๐Ÿข Past employer keywords", "type": "array", "description": "๐Ÿ”Ž One company name per line. Keeps only people whose earlier jobs mention one of these โ€” e.g. put your competitor's name here to find everyone this company hired away from them. Leave empty to keep everyone. Matching is case-insensitive and partial.", "items": { "type": "string" }, "default": [] }, "only_full_work_history": { "title": "โœ… Only people with a readable job history", "type": "boolean", "description": "๐Ÿงน LinkedIn hides older jobs behind asterisks on many public profiles. Turn this on to keep only the people whose history is actually readable, so your list has no half-blank rows. Off by default so nobody disappears without asking.", "default": false } } }, "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 } } } } } } } } } }