{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Scraper", "description": "Find people who currently work at LinkedIn companies: names, profile URLs, current titles, headlines, locations, seniority and functions, with optional profile and verified work-email enrichment. Filter by title, location, seniority and function. No login or cookies.", "version": "1.0", "x-build-id": "OBvh3GTyxNGswoClC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~linkedin-company-employees-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-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/coregent~linkedin-company-employees-scraper/runs": { "post": { "operationId": "runs-sync-coregent-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/coregent~linkedin-company-employees-scraper/run-sync": { "post": { "operationId": "run-sync-coregent-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": { "companies": { "title": "Companies", "type": "array", "description": "LinkedIn company URLs (https://www.linkedin.com/company/stripe/) or slugs (stripe) work best. Names (Stripe) also work; a name matching several LinkedIn companies is reported as AMBIGUOUS_COMPANY with the candidates instead of guessing.", "default": [ "https://www.linkedin.com/company/stripe/" ], "items": { "type": "string" } }, "profileMode": { "title": "Data depth", "enum": [ "BASIC", "PROFILE", "PROFILE_EMAIL" ], "type": "string", "description": "BASIC: name, profile URL, headline, title, location, seniority, function, company. PROFILE: adds public profile details and a second employment check. PROFILE_EMAIL: adds a work email, labelled VERIFIED, CATCH_ALL or UNVERIFIED. Each row is charged for what it actually carries.", "default": "BASIC" }, "maxEmployeesPerCompany": { "title": "Max employees per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many current employees per company. Coverage comes from public search results, so large companies usually return a partial set (coverageStatus PARTIAL_PUBLIC) rather than every employee.", "default": 100 }, "jobTitles": { "title": "Job titles", "type": "array", "description": "Keep only employees whose current title (or, failing that, headline) contains one of these phrases, e.g. \"Recruiter\", \"Account Executive\". The titles are also used to target the search, so they find more matching people rather than just filtering.", "default": [], "items": { "type": "string" } }, "excludeJobTitles": { "title": "Exclude job titles", "type": "array", "description": "Drop employees whose current title or headline contains any of these phrases, e.g. \"Intern\".", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep only employees whose public location contains one of these, e.g. \"Australia\", \"Sydney\", \"San Francisco Bay Area\". Employees with no public location are excluded when this is set.", "default": [], "items": { "type": "string" } }, "excludeLocations": { "title": "Exclude locations", "type": "array", "description": "Drop employees whose location contains any of these.", "default": [], "items": { "type": "string" } }, "seniorityLevels": { "title": "Seniority levels", "type": "array", "description": "Keep only these normalized seniority levels. Seniority is derived from the current title; a title that does not clearly indicate a level gets no seniority and is excluded when this filter is set.", "items": { "type": "string", "enum": [ "INTERN", "ENTRY", "ASSOCIATE", "SENIOR", "MANAGER", "DIRECTOR", "VP", "CXO", "OWNER", "PARTNER" ], "enumTitles": [ "Intern", "Entry level", "Associate", "Senior", "Manager", "Director / Head", "VP", "C-level", "Owner / Founder", "Partner" ] }, "default": [] }, "functions": { "title": "Functions / departments", "type": "array", "description": "Keep only these normalized functions, derived from the current title.", "items": { "type": "string", "enum": [ "SALES", "BUSINESS_DEVELOPMENT", "ENGINEERING", "INFORMATION_TECHNOLOGY", "HUMAN_RESOURCES", "MARKETING", "FINANCE", "OPERATIONS", "PRODUCT", "DESIGN", "LEGAL", "CONSULTING", "CUSTOMER_SUCCESS" ], "enumTitles": [ "Sales", "Business development", "Engineering", "Information technology", "Human resources / recruiting", "Marketing", "Finance", "Operations", "Product", "Design", "Legal", "Consulting", "Customer success / support" ] }, "default": [] }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text terms that must all appear in the employee's current title, headline, name or (in PROFILE modes) public About. Use quotes for phrases, e.g. \"machine learning\" platform.", "default": "" }, "minEmploymentMatchConfidence": { "title": "Minimum current-employment confidence", "enum": [ "MEDIUM", "HIGH" ], "type": "string", "description": "MEDIUM (default): at least one source clearly shows the company as the person's current position. HIGH: two independent signals, or the person's public profile itself, confirm it - fewer rows, higher precision. Former employees and people who merely mention the company are never returned.", "default": "MEDIUM" }, "includeCompanyDetails": { "title": "Include company details", "type": "boolean", "description": "Add industry, company size, LinkedIn employee count, headquarters and followers to each row's currentCompany object.", "default": true }, "includeCompanyStatusRows": { "title": "Include company status rows", "type": "boolean", "description": "Add one free row (rowType \"company_status\") for each company that could not be resolved, was ambiguous, or returned no employees, explaining why. Never charged.", "default": true }, "maxSearchPagesPerCompany": { "title": "Max search pages per company", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Upper bound on search-result pages read per company. 0 = automatic (scaled to Max employees per company). Lower it to make runs faster at the cost of depth.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for LinkedIn company and profile pages. Apify Datacenter proxy is the default. Apify Residential proxy is not supported (the run fails at startup); to use residential routing supply your own provider via Custom proxy URLs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }