{ "openapi": "3.0.1", "info": { "title": "Email Finder: Find Work Emails by Name & Company Domain", "description": "Email finder for B2B sales and recruiting: enter first name, last name and company domain, get the most likely work email. Ranks patterns from addresses published on the company site, checks MX, syntax, disposable and typos. Works for US and global companies. No SMTP. $3 per 1,000.", "version": "0.1", "x-build-id": "j6rIeDO9bYJzn2pZN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datadesk-io~email-finder-by-name-domain/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datadesk-io-email-finder-by-name-domain", "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/datadesk-io~email-finder-by-name-domain/runs": { "post": { "operationId": "runs-sync-datadesk-io-email-finder-by-name-domain", "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/datadesk-io~email-finder-by-name-domain/run-sync": { "post": { "operationId": "run-sync-datadesk-io-email-finder-by-name-domain", "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": { "contacts": { "title": "Contacts (name + company domain)", "type": "array", "description": "List of people to find. Each item is {\"firstName\",\"lastName\",\"domain\"} (or {\"fullName\",\"domain\"}), or a string like \"Jane Doe, hubspot.com\". Leave empty and fill only 'Emails to check' to just validate addresses." }, "emailsToCheck": { "title": "Emails to check (optional)", "type": "array", "description": "Optional addresses to validate at domain level: syntax, MX, disposable, free provider, role-based, typo suggestion. It does NOT check that the mailbox exists.", "items": { "type": "string" } }, "candidatesPerContact": { "title": "Candidates per contact", "minimum": 1, "maximum": 11, "type": "integer", "description": "How many ranked email candidates to return per person (the best goes in 'email', the rest in 'alternatives').", "default": 3 }, "scanWebsite": { "title": "Scan the company website for evidence", "type": "boolean", "description": "Reads a few pages of the company site (home, contact, about, team) to find published addresses. They raise the confidence of a matching pattern. Turn off for faster, pattern-only results.", "default": true }, "maxPagesPerDomain": { "title": "Max pages per website", "minimum": 1, "maximum": 10, "type": "integer", "description": "Pages to read per company domain when scanning the website.", "default": 4 }, "includeFailedRows": { "title": "Include rows without candidates (free)", "type": "boolean", "description": "Also output contacts whose domain is invalid, has no MX or is disposable, with the reason. Those rows are never charged.", "default": false }, "maxResults": { "title": "Max results in total", "minimum": 1, "type": "integer", "description": "Hard cap on charged rows for the whole run. Never exceeded." } } }, "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 } } } } } } } } } }