{ "openapi": "3.0.1", "info": { "title": "LinkedIn Company Employees Change Tracker", "description": "Track workforce changes across LinkedIn companies over time: new hires, departures, promotions, title, seniority, function and location changes, and headcount movement, from persistent employee snapshots with safe departure confirmation. No login or cookies.", "version": "1.0", "x-build-id": "6e7GoGdFZ1LB6ldnc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~linkedin-company-employees-change-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-linkedin-company-employees-change-tracker", "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-change-tracker/runs": { "post": { "operationId": "runs-sync-coregent-linkedin-company-employees-change-tracker", "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-change-tracker/run-sync": { "post": { "operationId": "run-sync-coregent-linkedin-company-employees-change-tracker", "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 (Atlassian) also work; a name matching several LinkedIn companies is reported as AMBIGUOUS_COMPANY instead of guessing. Each company keeps its own history under the tracker key.", "default": [ "https://www.linkedin.com/company/stripe/" ], "items": { "type": "string" } }, "trackerKey": { "title": "Tracker key", "type": "string", "description": "Name of this monitoring project, e.g. \"saas-competitors\" or \"target-accounts\". History is saved per tracker key + company, so two projects can watch the same company with different filters without mixing. Keep it the same on every scheduled run.", "default": "default" }, "mode": { "title": "Mode", "enum": [ "MONITOR", "BASELINE", "COMPARE" ], "type": "string", "description": "MONITOR (recommended): report changes since the previous run; the first run creates the baseline. BASELINE: save a fresh baseline now and report nothing. COMPARE: like MONITOR, plus re-lists every change saved in the longest comparison period selected below (e.g. the last 90 days).", "default": "MONITOR" }, "maxEmployeesPerCompany": { "title": "Max employees per company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Most employees observed (and charged) per company per run. A roster that hits this cap is marked CAPPED: who makes the cut varies between runs, so absence is not counted toward departures - departures are then confirmed only from direct evidence. Keep it the same on every run of a tracker; changing it starts a new baseline.", "default": 1000 }, "jobTitles": { "title": "Job titles", "type": "array", "description": "Track only employees whose current title (or headline) contains one of these phrases, e.g. \"Sales\", \"Engineer\", \"Recruiter\". The titles also target the search, so they find more matching people.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Track only employees whose public location contains one of these, e.g. \"Australia\", \"Sydney\". Employees with no public location are excluded when this is set.", "default": [], "items": { "type": "string" } }, "seniorityLevels": { "title": "Seniority levels", "type": "array", "description": "Track only these seniority levels (derived from the current title). DIRECTOR + VP + CXO is an executive-movement tracker.", "items": { "type": "string", "enum": [ "INTERN", "ENTRY", "ASSOCIATE", "SENIOR", "MANAGER", "DIRECTOR", "VP", "CXO", "OWNER", "PARTNER" ], "enumTitles": [ "Intern", "Entry level", "Associate", "Senior", "Manager", "Director", "VP", "CXO", "Owner / founder", "Partner" ] }, "default": [] }, "functions": { "title": "Functions", "type": "array", "description": "Track only these functions / departments (derived from the current title), e.g. Sales for a sales-team tracker.", "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", "HR / recruiting", "Marketing", "Finance", "Operations", "Product", "Design", "Legal", "Consulting", "Customer success" ] }, "default": [] }, "trackTitleChanges": { "title": "Track title changes", "type": "boolean", "description": "Report TITLE_CHANGED when a known employee's current title changes. Punctuation, case and common abbreviations (Sr. / Senior) are ignored.", "default": true }, "detectPromotions": { "title": "Detect promotions", "type": "boolean", "description": "Classify a title change as PROMOTED when seniority clearly moves up (Manager -> Director, Director -> VP, Senior Director > Director). Ambiguous renames such as Product Manager -> Product Lead stay plain title changes.", "default": true }, "trackSeniorityChanges": { "title": "Track seniority changes", "type": "boolean", "description": "Report SENIORITY_CHANGED when the normalized seniority level changes (up or down).", "default": true }, "trackFunctionChanges": { "title": "Track function / role changes", "type": "boolean", "description": "Report FUNCTION_CHANGED, and ROLE_CHANGED when a title change also moves the person into another function (Account Executive -> Partnerships Manager).", "default": true }, "trackLocationChanges": { "title": "Track location changes", "type": "boolean", "description": "Report LOCATION_CHANGED when a known employee's city changes (Sydney -> Singapore). Different labels for the same city are ignored.", "default": true }, "detectDepartures": { "title": "Detect departures", "type": "boolean", "description": "Report EMPLOYEE_DEPARTED once a departure is confirmed: by evidence (search or the profile shows another current employer) or by repeated absence from trustworthy scans. Missing once is never a departure.", "default": true }, "departureConfirmationRuns": { "title": "Runs missing before a departure is confirmed", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many trustworthy scans (coverage COMPLETE_OR_HIGH) in a row an employee must be missing before absence alone confirms a departure. Capped, partial and unstable scans never count. Direct evidence of a new employer confirms sooner.", "default": 2 }, "includeUncertainChanges": { "title": "Include uncertain changes", "type": "boolean", "description": "Also output LOW-confidence rows: people seen for the first time who are probably not new hires (NEWLY_DISCOVERED), employees missing from one scan (EMPLOYEE_UNCERTAIN), and title wording differences. Off by default so the dataset holds changes you can act on.", "default": false }, "verifyDeparturesWithProfile": { "title": "Verify missing employees on their profile", "type": "boolean", "description": "Look up the public profile of employees the scan missed, to confirm a move to another company (HIGH confidence, with the new employer) or to keep someone search simply did not surface. Not charged. Bounded by the setting below.", "default": true }, "maxProfileChecksPerCompany": { "title": "Max profile checks per company", "minimum": 0, "maximum": 500, "type": "integer", "description": "Most profile look-ups per company per run (also limited to 10% of the roster, minimum 5). People search showed at another employer go first, then likely departures, executives first.", "default": 25 }, "emitBaselineEmployees": { "title": "Output the baseline roster", "type": "boolean", "description": "On a baseline run, also output every employee found (as EMPLOYEE_ADDED / NEWLY_DISCOVERED, isBaseline: true). Off by default: a first run is not a wave of new hires.", "default": false }, "includeCompanySummary": { "title": "Include company summaries", "type": "boolean", "description": "Add one company_summary row per company: run status, coverage, observed and LinkedIn employee counts with deltas, change counts, function / seniority / location mix, period comparisons and workforce signals.", "default": true }, "comparisonPeriods": { "title": "Comparison periods", "type": "array", "description": "Periods compared in each company summary (PREVIOUS = the last run). The longest selected period is also the window COMPARE mode re-lists.", "items": { "type": "string", "enum": [ "PREVIOUS", "7_DAYS", "30_DAYS", "90_DAYS", "180_DAYS", "365_DAYS" ], "enumTitles": [ "Previous run", "7 days", "30 days", "90 days", "180 days", "365 days" ] }, "default": [ "PREVIOUS", "30_DAYS", "90_DAYS" ] }, "saveHistory": { "title": "Save history datasets", "type": "boolean", "description": "Append every company snapshot and change event to the named datasets linkedin-company-workforce-history and linkedin-company-workforce-events on your account, so the full history can be queried later. The latest state is always saved regardless.", "default": true }, "minEmploymentMatchConfidence": { "title": "Minimum current-employment confidence", "enum": [ "MEDIUM", "HIGH" ], "type": "string", "description": "MEDIUM (default): one clear current-position signal is enough to count someone as a current employee. HIGH: require two, for a smaller but stricter roster. Changing it starts a new baseline.", "default": "MEDIUM" }, "maxSearchPagesPerCompany": { "title": "Max search pages per company", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Upper bound on search requests per company. 0 = automatic (scaled to Max employees per company).", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for LinkedIn company and profile pages. Apify Datacenter is the default. Apify Residential is not supported — a run that selects it uses Apify Datacenter instead, with a warning; bring your own residential provider via Custom proxy URLs instead.", "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 } } } } } } } } } }