{ "openapi": "3.0.1", "info": { "title": "Email Verifier - Bulk Email Validation & List Cleaning API", "description": "Verify and clean bulk email lists: syntax, domain and MX checks, 8,700+ disposable providers, role accounts, free-mailbox detection and typo correction that recovers gmial.com as gmail.com. Every row says exactly what was checked and what was not.", "version": "1.0", "x-build-id": "Nj7SlhsHzxaYsEYeM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/appdata-labs~email-verifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-appdata-labs-email-verifier", "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/appdata-labs~email-verifier/runs": { "post": { "operationId": "runs-sync-appdata-labs-email-verifier", "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/appdata-labs~email-verifier/run-sync": { "post": { "operationId": "run-sync-appdata-labs-email-verifier", "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": { "emails": { "title": "Email addresses to verify", "type": "array", "description": "The addresses to check. Pasted forms such as \"Jane Doe \" are accepted and unwrapped, and duplicates are removed before anything is charged.", "default": [ "someone@gmail.com", "sales@stripe.com", "info@apify.com", "jane.doe@shopify.com", "hello@notion.so", "support@github.com", "test@mailinator.com", "temp@guerrillamail.com", "user@gmial.com", "someone@hotmial.com", "nobody@nosuchdomain-xyz-98765.com", "not-an-email", "Jane Doe " ], "items": { "type": "string" } }, "checkMailbox": { "title": "Also ask the mail server whether the mailbox exists (SMTP)", "type": "boolean", "description": "Off by default. When on, the Actor opens an SMTP conversation with the domain’s mail server and asks whether it would accept mail for the address. Cloud hosts commonly block outbound port 25 — when that happens the run says so in smtpChecked and smtpReason rather than guessing.", "default": false }, "onlyDeliverable": { "title": "Return only addresses worth sending to", "type": "boolean", "description": "Drops anything judged undeliverable — bad syntax, dead domains, no MX, disposable providers. You are only charged for rows returned, so this is also the cheapest way to clean a large list.", "default": false }, "excludeRoleAccounts": { "title": "Drop role accounts", "type": "boolean", "description": "Removes info@, sales@, support@ and about forty other function addresses. They rarely bounce and rarely reply, and cold outreach to them is what gets a sending domain blocklisted.", "default": false }, "excludeFreeProviders": { "title": "Drop free mailbox providers", "type": "boolean", "description": "Removes Gmail, Yahoo, Outlook and similar. Useful for B2B lists, where a personal mailbox tells you nothing about where someone works.", "default": false }, "concurrency": { "title": "Addresses checked at once", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many lookups run in parallel. Higher is faster on large lists; DNS resolvers start refusing above about thirty.", "default": 10 } } }, "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 } } } } } } } } } }