{ "openapi": "3.0.1", "info": { "title": "LinkedIn New Hires Finder", "description": "Give it a company name or LinkedIn URL and get the decision makers who started there recently, with the month they started and the company they left. No login, no cookies.", "version": "0.1", "x-build-id": "ju7xfQSCmfdRFjfWw" }, "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": "Companies to check", "maxItems": 200, "type": "array", "description": "One LinkedIn company URL or plain company name per line, up to 200 in a run. A URL such as https://www.linkedin.com/company/hubspot/ is matched against that company page; a plain name matches any company with that name. Very long lists end with the companies finished so far when the run timeout nears, and the log names a batch size to resubmit with.", "items": { "type": "string" } }, "maxTenureMonths": { "title": "Tenure window in months", "minimum": 1, "maximum": 36, "type": "integer", "description": "Months since the role began. A decision maker is charged only when their start month at this company falls inside the window. 1 to 36. Older starts and unknown starts are still delivered, free.", "default": 12 }, "enrichHireDates": { "title": "Read the public profile before charging", "type": "boolean", "description": "For each row that could be charged, the person's public LinkedIn profile is read through Apify residential proxy to confirm the current employer and the month the role began. Switch it off and nothing is confirmed, so every row is delivered free.", "default": true }, "maxRowsPerCompany": { "title": "Rows per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Stop after this many rows for one company, charged and free together. 1 to 50, and 10 when left empty. The same number caps how many public profiles are read for that company." }, "seniorityBands": { "title": "Decision maker bands", "type": "array", "description": "Bands to deliver. Rows outside the bands you pick are neither delivered nor charged, and nobody below director is ever delivered. An empty list means all five.", "items": { "type": "string", "enum": [ "owner", "partner", "cxo", "vp", "director" ], "enumTitles": [ "Owners, founders and proprietors", "Partners", "C level: chief officers, presidents, general counsel", "Vice presidents", "Directors and heads of" ] }, "default": [ "owner", "partner", "cxo", "vp", "director" ] }, "departments": { "title": "Departments", "type": "array", "description": "Keep only decision makers in these functions, read from the title and headline, for example sales and marketing for a go to market list. Empty means every department.", "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" ] } }, "targetTitles": { "title": "Titles to search for", "maxItems": 30, "type": "array", "description": "Job titles searched at each company, up to 30, six to a Google query. Leave it empty for the built in set: CEO, CTO, CFO, COO, CMO, President, Founder, Co-Founder, Owner, Managing Director and eight Spanish titles. The built in set is skipped for lists above 50 companies; pass your own titles to search a long list by title anyway.", "items": { "type": "string" } }, "searchQuery": { "title": "Extra search keyword", "type": "string", "description": "A keyword added, in quotes, to the base company search, for example fintech or supply chain. It is not added to the title searches." }, "location": { "title": "Location phrase", "type": "string", "description": "A place added, in quotes, to every search query, for example United States or Berlin." }, "maxConcurrency": { "title": "Companies in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many companies are searched at the same time. The run never goes above 3, whatever you set.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google searches go through the Apify GOOGLE_SERP proxy group and profile reads through Apify residential. A country you set here is used for both. Custom proxy URLs and other groups are ignored with a warning in the log." } } }, "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 } } } } } } } } } }