{ "openapi": "3.0.1", "info": { "title": "Company People Finder - Owners, Staff & Verified Emails", "description": "Find the owners, executives and staff of any company from its domain, each with the line on the company's own site that names their role. Add verified work emails and LinkedIn employees. Businesses where nobody is found are free.", "version": "0.1", "x-build-id": "jZhn0dA9CG1cBUZwl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leadproof~company-people-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leadproof-company-people-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/leadproof~company-people-finder/runs": { "post": { "operationId": "runs-sync-leadproof-company-people-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/leadproof~company-people-finder/run-sync": { "post": { "operationId": "run-sync-leadproof-company-people-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", "properties": { "domains": { "title": "Company websites", "type": "array", "description": "One company domain per line, like acme.com. That is all a row needs.", "items": { "type": "string" } }, "targetRoles": { "title": "Who do you want?", "type": "array", "description": "Pick the roles, or Everyone for the whole team. Left empty: owners, founders and executives.", "items": { "type": "string", "enum": [ "all", "owner", "founder", "executive", "partner", "purchasing", "operations", "finance", "marketing", "sales", "hr", "it", "clinical", "advisor" ], "enumTitles": [ "Everyone (all staff)", "Owner", "Founder", "Executive (CEO, president, director, VP)", "Partner", "Purchasing / procurement", "Operations", "Finance", "Marketing", "Sales", "HR / people", "IT / technology", "Clinical (doctors, dentists, vets...)", "Advisor / board" ] } }, "sources": { "title": "Where to look", "type": "array", "description": "Company website: the people the company publishes, each with the line that proves the role. LinkedIn: adds people from LinkedIn employee listings ($0.01 each). Pick both for the fullest list.", "items": { "type": "string", "enum": [ "website", "linkedin" ], "enumTitles": [ "Company website", "LinkedIn" ] }, "default": [ "website" ] }, "inferEmails": { "title": "Find verified work emails", "type": "boolean", "description": "Works out each person's work email from the company's own address pattern and checks the mailbox. Only confirmed addresses are returned, $0.03 each. Never a generic info@.", "default": false }, "maxPeoplePerBusiness": { "title": "Max people per company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Left empty: 5, or 100 when you pick Everyone." }, "businesses": { "title": "Companies with more detail (optional)", "type": "array", "description": "One object per company: {inputId, name, website, city, region, country}. A row needs a website, or a name with a city, region or country." }, "findProfileLinks": { "title": "Add a LinkedIn link to each person", "type": "boolean", "description": "One search per person without a profile link. Included in the price.", "default": false }, "verifyEmails": { "title": "Check published emails", "type": "boolean", "description": "Checks that the addresses printed on the site accept mail. Included in the price.", "default": false }, "includeFormer": { "title": "Include former staff", "type": "boolean", "description": "Off: people a page describes as former are left out.", "default": false }, "judgePeople": { "title": "Filter names with AI", "type": "boolean", "description": "Removes testimonial authors, product names and headings, and reads the role of people the page names without a title. About $0.0006 per company, billed by Apify's AI proxy.", "default": true }, "country": { "title": "Country for web searches", "type": "string", "description": "Two letters, like US or GB. Optional." }, "language": { "title": "Language", "type": "string", "description": "Like en or de.", "default": "en" }, "renderMode": { "title": "Page render mode", "enum": [ "http", "auto", "browser" ], "type": "string", "description": "HTTP is fastest. Use Browser for sites built with JavaScript.", "default": "http" }, "maxPagesPerBusiness": { "title": "Pages per company", "minimum": 1, "maximum": 25, "type": "integer", "description": "Pages of each company site to read.", "default": 8 }, "maxSearchesPerBusiness": { "title": "Web searches per company", "minimum": 0, "maximum": 10, "type": "integer", "description": "Used only when the site names nobody you asked for. 0 turns search off.", "default": 1 }, "maxEmailChecksPerBusiness": { "title": "Email checks per company", "minimum": 0, "maximum": 50, "type": "integer", "description": "Most mailbox checks per company when finding emails.", "default": 12 }, "maxProviderEmployees": { "title": "LinkedIn people per company", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most people asked from LinkedIn listings per company.", "default": 50 }, "concurrency": { "title": "Companies at a time", "minimum": 1, "maximum": 8, "type": "integer", "description": "Rows still come back in your order.", "default": 4 }, "maxSecondsPerBusiness": { "title": "Seconds per company", "minimum": 30, "maximum": 900, "type": "integer", "description": "A company that hits this returns what it found so far.", "default": 180 }, "maxRunSeconds": { "title": "Run time limit (seconds)", "minimum": 60, "maximum": 21600, "type": "integer", "description": "The run stops starting new companies after this long.", "default": 3600 }, "searchUnresolvedRoles": { "title": "Search for every missing role", "type": "boolean", "description": "Off: one search only when the site named nobody. On: a search per role the site did not answer.", "default": false }, "linkedinStaffSearch": { "title": "LinkedIn web search", "type": "boolean", "description": "Override. Left empty: on when LinkedIn is a source." }, "employeeProvider": { "title": "Employee list provider (Store Actor)", "enum": [ "none", "auto", "atomus/linkedin-company-employees", "harvestapi/linkedin-company-employees" ], "type": "string", "description": "Override. Left empty: Auto when LinkedIn is a source. Auto uses the company's LinkedIn page when the site links it, otherwise the domain." }, "maxProfileSearchesPerBusiness": { "title": "Profile searches per business", "minimum": 0, "maximum": 25, "type": "integer", "description": "Most LinkedIn link searches per company.", "default": 10 }, "maxPagesTotal": { "title": "Pages per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Pages across the whole run.", "default": 200 }, "maxSearchesTotal": { "title": "Searches per run", "minimum": 0, "maximum": 600, "type": "integer", "description": "Searches across the whole run. 0 turns search off.", "default": 60 } } }, "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 } } } } } } } } } }