{
"openapi": "3.0.1",
"info": {
"title": "B2B Decision Maker Email & Phone Finder",
"description": "Company domains → named decision makers with verified work emails, phone numbers and LinkedIn. B2B database + AI web research + SMTP verification. Any senior persona — CEO, founder, VP, ops, sales. Pay per result. No user API keys.",
"version": "0.7",
"x-build-id": "OaQ61BC9KQZnRAboB"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/pequod-labs~company-decision-maker-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-pequod-labs-company-decision-maker-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/pequod-labs~company-decision-maker-finder/runs": {
"post": {
"operationId": "runs-sync-pequod-labs-company-decision-maker-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/pequod-labs~company-decision-maker-finder/run-sync": {
"post": {
"operationId": "run-sync-pequod-labs-company-decision-maker-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": [
"domains"
],
"properties": {
"domains": {
"title": "Company domains",
"type": "array",
"description": "Company website domains to turn into named decision makers with verified emails and phones. Plain strings work for most cases: acme.com. To hint the company's country (improves the generic-inbox fallback and EU legal-notice phone lookup), use objects: {\"domain\": \"acme.de\", \"country\": \"DE\"}. Up to 1000 domains per run on paid Apify plans; free-plan users are limited to 5 domains per run and 5 domains per UTC calendar day."
},
"defaultCountry": {
"title": "Default country",
"enum": [
"",
"IT",
"DE",
"FR",
"NL",
"ES",
"GB",
"US",
"IE"
],
"type": "string",
"description": "Optional two-letter ISO country applied to all domains that don't specify their own. Used to try localized inbox prefixes (e.g. kontakt@ for DE, contatti@ for IT) in the generic-inbox fallback, and to pick the right EU legal-notice source for phone numbers.",
"default": ""
},
"verifyEmails": {
"title": "Verify email deliverability (SMTP)",
"type": "boolean",
"description": "Recommended. Runs SMTP-level verification on every candidate email. Only addresses that pass with top quality are marked email_sendable: true — the ones safe to use in cold outreach. Turning this off returns unverified addresses only.",
"default": true
},
"includeGenericInbox": {
"title": "Generic inbox fallback",
"type": "boolean",
"description": "When no verified decision-maker email is found, try localized generic inboxes (info@, contact@, kontakt@, …) so you still get a working contact channel for the company.",
"default": true
},
"aiDiscovery": {
"title": "AI web research",
"type": "boolean",
"description": "Recommended. When the B2B database has no match for a domain, researches the public web and extracts named decision makers with AI. Every extracted person must be explicitly named with a role in a public source — names are never invented. Turn off for faster, database-only runs with lower coverage.",
"default": true
},
"maxCandidates": {
"title": "Max candidates per domain",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Upper bound on decision-maker candidates evaluated per domain before picking the best one. Higher values improve the chance of a verified email at the cost of a slower run.",
"default": 5
},
"targetPersona": {
"title": "Target decision maker",
"type": "object",
"description": "Who to find for your sale. Use a preset — founder_ceo, sales_leader, marketing_leader, ops_logistics, procurement, finance_cfo, tech_leader, hr_people, ecommerce_owner — or custom title keywords. Optional acceptableRoles (e.g. [\"CEO\", \"Sales\"]) prevents penalizing valid executive fallbacks. Set executiveFallback to false to always prefer functional leaders on enterprise accounts.",
"default": {
"mode": "preset",
"preset": "founder_ceo"
}
},
"salesContext": {
"title": "What you sell (optional)",
"type": "object",
"description": "Optional shortcut: {\"productCategory\": \"shipping_software\"} maps to the right persona when targetPersona is omitted. companySize (smb, enterprise) adjusts executive vs functional preference.",
"default": {}
},
"maxContactsPerDomain": {
"title": "Max contacts per domain",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "Return up to this many ranked decision makers per domain (primary + alternates when returnAlternates is on).",
"default": 1
},
"returnAlternates": {
"title": "Include alternate contacts",
"type": "boolean",
"description": "When enabled with maxContactsPerDomain > 1, include additional ranked contacts in alternates.",
"default": false
},
"mustHaveVerifiedEmail": {
"title": "Require verified email for primary DM",
"type": "boolean",
"description": "Rank toward decision makers with SMTP-verified sendable emails. Generic inbox fallback still applies when no DM email verifies.",
"default": false
},
"companyFilters": {
"title": "Company filters (optional)",
"type": "object",
"description": "Quarantine whole companies you never want to contact. {\"excludeCompanyTypes\": [\"recruitment_agency\"]} keeps recruitment and staffing intermediaries out of the results — essential when you sell to employers, because job-ad-sourced lists are full of agencies posting on behalf of clients; it adds one evidence lookup per domain. {\"requireCountryMatch\": true} drops domains whose suffix belongs to another country than the one you gave (a .edu or .de domain in a UK campaign), before any lookup is paid for. Excluded companies are listed with their reason and evidence in the EXCLUDED_COMPANIES record of the key-value store, free of charge, and stay out of the paid dataset unless pushEmptyResults is enabled.",
"default": {}
},
"identityStrictness": {
"title": "Contact identity checks",
"enum": [
"flag",
"enforce",
"off"
],
"type": "string",
"description": "Cross-checks that a contact's name, email local part and LinkedIn slug describe the same person, and that the email sits on the requested company's domain. flag (default) annotates identity_status and lowers confidence when checks fail. enforce also discards contradictory contacts — use it when a wrong-person email costs more than a missing one. off restores the previous behaviour.",
"default": "flag"
},
"pushEmptyResults": {
"title": "Push empty results to dataset",
"type": "boolean",
"description": "Domains with no billable deliverable — no named decision maker, no sendable generic inbox, no phone, and no PEC — are kept out of the dataset by default, so you are not charged for gaps. They are always listed free of charge in the key-value store: unreachable ones under FAILED_DOMAINS, and companies quarantined by companyFilters under EXCLUDED_COMPANIES. Enable this only if you also want both as dataset items — in which case they are billed as domain results like any other row.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}