{ "openapi": "3.0.1", "info": { "title": "Decision Maker Email Finder - Owners, CEOs & Founders", "description": "Decision maker email finder for any list of company websites: the key decision makers each company names on its own site - owner, CEO, founders, the leadership team - with job title, LinkedIn, the source page and a work email the company published or its mail server confirmed. Pay only per email.", "version": "0.2", "x-build-id": "exyWhBlGg5rgZ48gS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandy_yclept~decision-maker-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandy_yclept-decision-maker-email-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/sandy_yclept~decision-maker-email-finder/runs": { "post": { "operationId": "runs-sync-sandy_yclept-decision-maker-email-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/sandy_yclept~decision-maker-email-finder/run-sync": { "post": { "operationId": "run-sync-sandy_yclept-decision-maker-email-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Company websites", "type": "array", "description": "The companies to find decision makers for, as websites or bare domains (\"acme.com\"), one per line. Each website is read for the people the company itself names: its team and about pages, its legal notice, the pages of single people.", "default": [ { "url": "https://www.andersongallagher.ie/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "seniority": { "title": "Who to return", "enum": [ "decision_makers", "owners", "everyone" ], "type": "string", "description": "Decision makers (default): owners, founders, partners, managing directors, CEOs, presidents, every chief officer, vice presidents, directors and heads of departments. Owners only: the people who own or lead the whole company. Everyone: every person the company names as its own, staff and advisers too. The rank is read from the job title the website prints.", "default": "decision_makers" }, "maxPeoplePerCompany": { "title": "People per company", "minimum": 1, "maximum": 25, "type": "integer", "description": "The most people to return for one company. Owners come before executives, and people with a published email before people without - so 1 returns the person at the top. A law firm may name forty attorneys; this is what caps the cost of one company.", "default": 3 }, "confirmEmails": { "title": "Confirm unpublished emails with the company's mail server", "type": "boolean", "description": "Most companies name the people who run them and do not print their addresses. For a person without a published email, the usual mailboxes of the name (jane@, jane.doe@, jdoe@ ...) are asked of the company's mail server, the likeliest first, and the first that exists is returned as `confirmed`. A server that accepts every address proves nothing and is never believed. The question goes through the bounceverify/bounceverify-email-verifier Actor in a separate run on your account, which bills each address it checks ($0.00089) - in our test 133 checks, $0.12, for 60 websites. Off: only emails published on the website are returned.", "default": true }, "maxContactPages": { "title": "Max contact and about subpages", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many contact-like subpages (/about, /contact, /team, /impressum) to read on each site, on top of its homepage. Up to 4 more team pages and 8 pages of single people are read on top of these, where the site has them.", "default": 5 }, "renderJs": { "title": "JavaScript rendering", "enum": [ "off", "auto", "on" ], "type": "string", "description": "Load pages in a real browser to read team pages that are built by JavaScript. Off (default) is the fastest and cheapest. Auto reads without a browser first and only re-reads a site in the browser when it named nobody who decides. On always uses the browser. Auto and On require the run memory to be at least 2048 MB. Below 1024 MB the browser is not started and the run says so.", "default": "off" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for fetching pages. Apify Proxy's datacenter IPs are included in every Apify plan, the Free plan too; residential proxies are billed separately. Left disabled, the Actor connects directly, and retries sites that refuse it through Apify Proxy (see below).", "default": { "useApifyProxy": false } }, "proxyFallback": { "title": "Retry refused sites through Apify Proxy", "type": "boolean", "description": "Every cloud run has a datacenter IP address, and some sites turn those away. A site that refuses or drops the direct connection is retried once through Apify Proxy's datacenter IPs (included in every Apify plan, the Free plan too), then once more directly. Sites that answer directly never go through the proxy, and robots.txt is respected either way. Has no effect when a proxy is configured above.", "default": true } } }, "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 } } } } } } } } } }