{ "openapi": "3.0.1", "info": { "title": "Decision Maker Finder - C-Suite Contacts with Verified Emails", "description": "Turn a list of companies into their decision makers - founders, C-suite, VPs and directors - with name, title, LinkedIn URL and a work email the company's mail server has confirmed, plus the company inbox and phone. Pay for emails only when confirmed. No LinkedIn login, zero ban risk.", "version": "0.0", "x-build-id": "OJnFAFfZXkUIo8nK3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~decision-maker-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~decision-maker-finder/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~decision-maker-finder/run-sync": { "post": { "operationId": "run-sync-memo23-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", "properties": { "companies": { "title": "Companies", "type": "array", "description": "One entry per company - a name (`Notion`) or a website (`stripe.com`). Websites work best: the search is more precise and the contact-email lookup goes straight to that site.", "items": { "type": "string" } }, "companiesText": { "title": "Companies (paste a list)", "type": "string", "description": "Alternative to the list above for bulk runs: paste one company per line, names or websites mixed. Example: `stripe.com` newline `Airtable` newline `notion.so`. Entries from both fields are merged and deduplicated. Default: empty." }, "excludeCompanies": { "title": "Never contact these companies", "type": "array", "description": "Companies to skip even when they appear in the list above - your own company, existing customers, competitors. Names or websites; `Acme` and `acme.com` both exclude the same company. Default: empty.", "items": { "type": "string" } }, "targetPersonas": { "title": "Buying-committee personas", "type": "array", "description": "Shortcut for a seat at the table: each persona expands into the seniority levels, the function and the titles it implies, so `finance` searches CFO, finance director and head of finance at every company. Pick several to cover a committee. Valid values: `founder-ceo`, `finance`, `marketing`, `sales`, `engineering`, `product`, `it-security`, `people`, `operations`. Default: empty, which leaves the two fields below in charge.", "items": { "type": "string", "enum": [ "founder-ceo", "finance", "marketing", "sales", "engineering", "product", "it-security", "people", "operations" ], "enumTitles": [ "Founder / CEO / Owner", "Finance (CFO, finance director)", "Marketing (CMO, head of marketing)", "Sales (CRO, VP sales)", "Engineering (CTO, VP engineering)", "Product (CPO, head of product)", "IT / Security (CIO, CISO)", "People / HR (CHRO, head of people)", "Operations (COO, head of operations)" ] } }, "seniorityLevels": { "title": "Seniority levels", "type": "array", "description": "Which seniority buckets to deliver. Default: CXO, Owner/Founder, VP and Director - the buying committee. Unions with any personas selected above.", "items": { "type": "string", "enum": [ "CXO", "Owner", "VP", "Director", "Partner", "Manager", "Senior", "Entry", "Intern" ], "enumTitles": [ "CXO (CEO, CTO, CFO…)", "Owner / Founder", "VP", "Director / Head of", "Partner", "Manager", "Senior IC", "Entry level", "Intern" ] } }, "jobFunctions": { "title": "Job functions", "type": "array", "description": "Optional: narrow to these functions. Example: `Marketing` finds CMOs, VPs of Marketing and Marketing Directors. Default: all functions.", "items": { "type": "string", "enum": [ "Sales", "Marketing", "Engineering", "Data", "Product", "Design", "Finance", "Human Resources", "Operations", "Legal", "IT", "Customer Success", "Consulting", "Education", "Healthcare" ] } }, "title": { "title": "Custom job title (optional)", "type": "string", "description": "A specific title searched FIRST at every company, e.g. `Head of Partnerships`. Default: empty." }, "location": { "title": "Location (optional)", "type": "string", "description": "Narrow the search to a location keyword, e.g. `Berlin`, `Milano`, `New York`. Useful for companies with many offices. Default: empty, which searches every office." }, "identityStrictness": { "title": "Identity strictness", "enum": [ "balanced", "strict" ], "type": "string", "description": "`balanced` (default) also accepts a profile whose headline states the role at this company (`CFO at Acme`), which is how most small-company profiles read. `strict` keeps only profiles whose structured data names this company as the current employer - fewer rows, no headline-based judgement.", "default": "balanced" }, "maxResultsPerCompany": { "title": "Max decision makers per company", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap per company. Default `5`, maximum `50`. A company with fewer findable people returns fewer rows, and you pay per delivered row.", "default": 5 }, "includeEmptyCompanies": { "title": "Report companies with no results", "type": "boolean", "description": "Add one free marker row (`noResults: true`) for every company where no decision maker matched, so a long input list maps 1:1 onto the dataset. Marker rows are never billed. Default `false`.", "default": false }, "findWorkEmails": { "title": "Find work emails (confirmed by the mail server)", "type": "boolean", "description": "For each decision maker, rank the standard corporate patterns (first.last@, flast@, first@ …) and ask the company's mail server which one exists. Adds `email`, `mailboxConfirmed`, `emailStatus`, `emailConfidence`, `emailPattern`, `emailProvider` and `mxValid` to every row. Billed only when the server confirms the exact mailbox; catch-all domains and unanswered checks keep the ranked guess for free. Default `true`.", "default": true }, "mustHaveVerifiedEmail": { "title": "Only deliver people with a confirmed work email", "type": "boolean", "description": "Drop anyone whose work email the mail server did not confirm, before the row is delivered or billed. Use it when every row has to be sendable; expect fewer rows, and none at catch-all domains. Turns the work-email lookup on by itself. Default `false`.", "default": false }, "returnAlternates": { "title": "Include alternate email candidates", "type": "boolean", "description": "Add `emailAlternates` to each row: up to five runner-up addresses with their pattern and SMTP answer, best first. Useful as a fallback in a sending sequence. Costs nothing extra. Default `false`.", "default": false }, "enrichEmails": { "title": "Find company contact emails", "type": "boolean", "description": "For each company, discover its website and scrape it for a contact email and phone - added to every row as `contactEmail` / `contactPhone` / `contactWebsite`. Billed once per company, only when an email is actually found. Turn off to skip the company inbox. Default `true`.", "default": true }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty - the actor routes through its own residential proxy. Only set this to use your own proxies." } } }, "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 } } } } } } } } } }