{ "openapi": "3.0.1", "info": { "title": "Email Finder by Name & Domain - Verified Work Emails", "description": "Email finder by name and domain: a person's verified work email from their first name, last name and company domain. Published on the company's website or confirmed by its mail server - never a guess. Bulk email lookup for lead lists and CRMs. Pay only per email found.", "version": "0.2", "x-build-id": "gpsrcPORQyKYCO8Q5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandy_yclept~work-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandy_yclept-work-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~work-email-finder/runs": { "post": { "operationId": "runs-sync-sandy_yclept-work-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~work-email-finder/run-sync": { "post": { "operationId": "run-sync-sandy_yclept-work-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", "properties": { "people": { "title": "People to find emails for", "type": "array", "description": "One object per person with a first name, a last name and the company's domain or website: {\"firstName\": \"Jane\", \"lastName\": \"Doe\", \"domain\": \"acme.com\"}. Also accepted: \"name\" or \"full_name\" with the whole name, \"first_name\" / \"last_name\" / \"surname\", \"website\" or \"url\" instead of \"domain\", and plain strings like \"Jane Doe, acme.com\". Titles (Dr., Herr) and letters after a name (MD, CPA) are dropped. A row without a name or domain, or at a mailbox provider (gmail.com), is invalid and free." }, "peopleDatasetId": { "title": "Or a dataset of people", "type": "string", "description": "The ID of an Apify dataset whose items carry a name and a company domain under any of the field names above - the output of a LinkedIn, Google Maps or decision-maker scraper, or a CSV you uploaded. Read in full, after the people listed above." }, "confirmEmails": { "title": "Confirm unpublished emails with the company's mail server", "type": "boolean", "description": "For a person without a published address, the usual mailboxes of the name are asked of the company's mail server - the company's own pattern first, then jane@, jane.doe@, jdoe@ ... - and the first that exists is returned as `confirmed`. A server that accepts every address proves nothing: the row says `catch_all` and is free. The checks run through bounceverify/bounceverify-email-verifier on your account, $0.00089 an address (our test: 161 checks, $0.14). Off: only published emails are returned.", "default": true }, "readWebsites": { "title": "Read the company websites first", "type": "boolean", "description": "On (default): each company's website is read before its mail server is asked - an address it prints costs no check, and the pattern its other addresses follow (i.doe@, doe@) makes the first question the right one in 94% of cases. Off: the mail server is asked straight away, in the common order; faster, more checks, no published addresses.", "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 company website, on top of its homepage, looking for published addresses. 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 }, "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 } } } } } } } } } }