{ "openapi": "3.0.1", "info": { "title": "LinkedIn New Hires Finder", "description": "Takes a company LinkedIn URL or name and returns decision makers who started there recently, with the month they started and the company they left. Charges only when the current employer matches and the start month is inside your window. No login, no cookies.", "version": "0.1", "x-build-id": "zrt9lqotrzkXXRjuf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agnes.developer.queen~linkedin-new-hires-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agnes.developer.queen-linkedin-new-hires-finder", "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/agnes.developer.queen~linkedin-new-hires-finder/runs": { "post": { "operationId": "runs-sync-agnes.developer.queen-linkedin-new-hires-finder", "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/agnes.developer.queen~linkedin-new-hires-finder/run-sync": { "post": { "operationId": "run-sync-agnes.developer.queen-linkedin-new-hires-finder", "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": "Company LinkedIn URLs or names", "maxItems": 200, "type": "array", "description": "LinkedIn company URLs such as https://www.linkedin.com/company/openai/ or plain company names. Mix both freely. Up to 200 companies per run. Large lists finish gracefully with partial coverage on the default 20 minute timeout, so split very large lists.", "items": { "type": "string" } }, "seniorityBands": { "title": "Seniority bands to include", "type": "array", "description": "Which decision maker bands to deliver and charge. Everyone outside the decision maker set (managers, seniors, individual contributors, interns) is always skipped before any charge.", "items": { "type": "string", "enum": [ "owner", "partner", "cxo", "vp", "director" ], "enumTitles": [ "Owner or founder", "Partner", "C level (CEO, CTO, CFO, COO, CMO and any chief officer)", "Vice president", "Director or head of" ] }, "default": [ "owner", "partner", "cxo", "vp", "director" ] }, "departments": { "title": "Departments to include", "type": "array", "description": "Leave empty for every department. Pick some to deliver and charge only decision makers in those functions, for example sales and marketing for a GTM list.", "items": { "type": "string", "enum": [ "executive", "sales", "marketing", "engineering", "data", "product", "design", "finance", "hr", "legal", "support", "operations", "other" ], "enumTitles": [ "Executive", "Sales", "Marketing", "Engineering", "Data", "Product", "Design", "Finance", "HR", "Legal", "Support", "Operations", "Other" ] } }, "maxTenureMonths": { "title": "Max tenure in months", "minimum": 1, "maximum": 36, "type": "integer", "description": "Only charge decision makers whose current role started within this many months. Default 12. Rows outside the window are still emitted and are free.", "default": 12 }, "enrichHireDates": { "title": "Fetch public profiles when the start month is missing", "type": "boolean", "description": "When Google does not expose a start month, fetch the public LinkedIn profile through Apify residential to read experience dates. Turn off to stay on indexed text only.", "default": true }, "maxDecisionMakersPerCompany": { "title": "Max decision makers per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Stop after this many rows per company. Between 1 and 50.", "default": 10 }, "targetTitles": { "title": "Target titles", "maxItems": 30, "type": "array", "description": "Titles used to expand the Google search per company. Leave empty for the built in set (CEO, CTO, CFO, COO, CMO, President, Founder, Co-Founder, Owner, Managing Director plus Spanish equivalents). Pass your own list, for example Head of Sales and VP Marketing, for a narrower ICP. Up to 30 titles.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional location phrase added to the search, for example United States or Berlin." }, "searchQuery": { "title": "Extra keyword", "type": "string", "description": "Optional extra keyword added to the base company search, for example fintech or supply chain." }, "compareWithPreviousRun": { "title": "Monitor new decision makers vs previous run (free)", "type": "boolean", "description": "On a scheduled run, adds one free company-diff-summary row per company listing the decision makers who appeared since your previous run, the ones who left the list and title changes. Snapshots live in a key value store in your own account and are never charged.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Companies processed in parallel. Between 1 and 10.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Discovery runs through the Apify GOOGLE_SERP proxy group. Country routing is honored. Custom proxy URLs and other groups are ignored." } } }, "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 } } } } } } } } } }