{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Scraper", "description": "LinkedIn Company Employees Scraper — Extract LinkedIn employee data including names, job titles, locations, profile URLs, current positions, and company details. Useful for lead generation, hiring research, prospecting, competitor analysis, and business intelligence.", "version": "0.2", "x-build-id": "kSVWxEzSZ7DgbiKSz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~linkedin-company-employees-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-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/socialdataapi~linkedin-company-employees-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-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/socialdataapi~linkedin-company-employees-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-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": [ "companies" ], "properties": { "companies": { "title": "🔗 Companies", "minItems": 1, "maxItems": 1000000, "type": "array", "description": "One or more LinkedIn companies, one per line: a full company URL (e.g. https://www.linkedin.com/company/google) or just a company name (e.g. google). Up to 1000 entries.", "items": { "type": "string" } }, "profileScraperMode": { "title": "🔧 Profile scrape depth", "enum": [ "short", "full", "email" ], "type": "string", "description": "How much of each employee's profile to scrape. Short: identity, headline, location, photo and current position only. Full: everything Short has, plus experience, education, skills, certifications, and other profile sections, with company details attached to each position. Full + email search: everything Full has, plus an attempt to find a work email address for each person in public web results and on the profile (not guaranteed; often empty).", "default": "full" }, "maxItems": { "title": "🔢 Max employees per company", "minimum": 1, "type": "integer", "description": "Stop after this many employee rows for each company listed above (default 10). Example: 2 companies and 150 return up to 300 rows. Free plan: up to 20 employees per run (all companies together) and 200 per month; paid plans have no limit.", "default": 10 }, "locations": { "title": "📍 Locations", "maxItems": 10, "type": "array", "description": "Only keep employees whose profile location matches one of these (phrase match), e.g. \"United States\", \"San Francisco\". Up to 50 entries.", "items": { "type": "string" } }, "searchQuery": { "title": "🔎 Search query", "maxLength": 300, "type": "string", "description": "Extra free-text filter: every word must appear in the employee's name, headline, current title, or about section. Up to 300 characters." }, "jobTitles": { "title": "🎯 Current job titles", "maxItems": 10, "type": "array", "description": "Only keep employees whose current title or headline contains every word of at least one of these, e.g. \"Software Engineer\". Up to 50 entries.", "items": { "type": "string" } }, "pastJobTitles": { "title": "🎯 Past job titles", "maxItems": 10, "type": "array", "description": "Only keep employees with a past position whose title matches one of these. Up to 50 entries.", "items": { "type": "string" } }, "schools": { "title": "🎯 Schools", "maxItems": 10, "type": "array", "description": "Only keep employees whose education lists one of these schools. Up to 50 entries.", "items": { "type": "string" } }, "industryIds": { "title": "🆔 Current company industries", "maxItems": 10, "type": "array", "description": "Only keep employees whose current company's LinkedIn industry id is one of these (LinkedIn's official industry code list, e.g. \"4\" = Software Development). Up to 50 entries.", "items": { "type": "string" } }, "yearsAtCurrentCompanyIds": { "title": "🆔 Years at current company", "maxItems": 5, "type": "array", "description": "Only keep employees whose time at their current company falls in one of these buckets: 1 = under 1 year, 2 = 1-2 years, 3 = 3-5 years, 4 = 6-10 years, 5 = over 10 years. Needs start dates, which most public profiles hide, so this filter keeps few employees.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] } }, "yearsOfExperienceIds": { "title": "🆔 Years of experience", "maxItems": 5, "type": "array", "description": "Same buckets as above, measured from the employee's earliest known position start date instead. Needs start dates, which most public profiles hide.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] } }, "seniorityLevelIds": { "title": "🆔 Seniority levels", "maxItems": 10, "type": "array", "description": "Only keep employees whose current title matches one of these LinkedIn seniority levels. A title that matches none of LinkedIn's seniority wording is left unclassified and never matches this filter.", "items": { "type": "string", "enum": [ "100", "110", "120", "130", "200", "210", "220", "300", "310", "320" ], "enumTitles": [ "In Training", "Entry Level", "Senior", "Strategic", "Entry Level Manager", "Experienced Manager", "Director", "Vice President", "CXO", "Owner / Partner" ] } }, "functionIds": { "title": "🆔 Job functions", "maxItems": 26, "type": "array", "description": "Only keep employees whose current title matches one of these LinkedIn job functions.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26" ], "enumTitles": [ "Accounting", "Administrative", "Arts and Design", "Business Development", "Community and Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Finance", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Marketing", "Media and Communications", "Military and Protective Services", "Operations", "Product Management", "Program and Project Management", "Purchasing", "Quality Assurance", "Real Estate", "Research", "Sales", "Customer Success and Support" ] } }, "companyHeadcount": { "title": "🆔 Current company size", "maxItems": 9, "type": "array", "description": "Only keep employees whose current company's declared employee-count range matches one of these.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I" ], "enumTitles": [ "Self-employed", "1-10", "11-50", "51-200", "201-500", "501-1,000", "1,001-5,000", "5,001-10,000", "10,001+" ] } }, "recentlyChangedJobs": { "title": "✅ Recently changed jobs only", "type": "boolean", "description": "Only keep employees whose current position started within the last 2 calendar months (about 90 days). Needs a start date on the public profile.", "default": false }, "excludeLocations": { "title": "📍 Exclude locations", "maxItems": 10, "type": "array", "description": "Drop employees whose profile location matches one of these. Up to 50 entries.", "items": { "type": "string" } }, "excludePastCompanies": { "title": "🔗 Exclude past companies", "maxItems": 10, "type": "array", "description": "Drop employees who held a past position at one of these companies (LinkedIn company URLs or names). Up to 50 entries.", "items": { "type": "string" } }, "excludeSchools": { "title": "🎯 Exclude schools", "maxItems": 10, "type": "array", "description": "Drop employees whose education lists one of these schools. Up to 50 entries.", "items": { "type": "string" } }, "excludeCurrentJobTitles": { "title": "🎯 Exclude current job titles", "maxItems": 10, "type": "array", "description": "Drop employees whose current title or headline matches one of these. Up to 50 entries.", "items": { "type": "string" } }, "excludePastJobTitles": { "title": "🎯 Exclude past job titles", "maxItems": 10, "type": "array", "description": "Drop employees who held a past position with a title matching one of these. Up to 50 entries.", "items": { "type": "string" } }, "excludeIndustryIds": { "title": "🆔 Exclude current company industries", "maxItems": 10, "type": "array", "description": "Drop employees whose current company's LinkedIn industry id is one of these. Up to 50 entries.", "items": { "type": "string" } }, "excludeSeniorityLevelIds": { "title": "🆔 Exclude seniority levels", "maxItems": 10, "type": "array", "description": "Drop employees whose current title matches one of these LinkedIn seniority levels.", "items": { "type": "string", "enum": [ "100", "110", "120", "130", "200", "210", "220", "300", "310", "320" ], "enumTitles": [ "In Training", "Entry Level", "Senior", "Strategic", "Entry Level Manager", "Experienced Manager", "Director", "Vice President", "CXO", "Owner / Partner" ] } }, "excludeFunctionIds": { "title": "🆔 Exclude job functions", "maxItems": 26, "type": "array", "description": "Drop employees whose current title matches one of these LinkedIn job functions.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26" ], "enumTitles": [ "Accounting", "Administrative", "Arts and Design", "Business Development", "Community and Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Finance", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Marketing", "Media and Communications", "Military and Protective Services", "Operations", "Product Management", "Program and Project Management", "Purchasing", "Quality Assurance", "Real Estate", "Research", "Sales", "Customer Success and Support" ] } }, "companyBatchMode": { "title": "🔧 Company batching", "enum": [ "all_at_once", "one_by_one" ], "type": "string", "description": "\"All at once\" scrapes every company at the same time. \"One by one\" scrapes them in turn. Either way each company gets its own Max employees per company.", "default": "all_at_once" }, "maxItemsPerCompany": { "title": "🔢 Max employees per company (override)", "minimum": 1, "type": "integer", "description": "Optional. When set, replaces Max employees per company above for every company. Leave empty to use that value." }, "startPage": { "title": "🔢 Start page", "minimum": 0, "maximum": 100, "type": "integer", "description": "For each company, skip the first (N-1) x 25 matching employees and start returning results from result page N. 1 = no skip.", "default": 1 }, "takePages": { "title": "🔢 Number of pages", "minimum": 0, "maximum": 100, "type": "integer", "description": "For each company, return at most this many result pages (25 matching employees each). Leave empty for no page cap (still bounded by Max employees per company)." }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Proxy used for LinkedIn requests. Residential is recommended. Your own proxy URLs are supported. Turning the proxy off may reduce the number of results." } } }, "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 } } } } } } } } } }