{ "openapi": "3.0.1", "info": { "title": "Email Verifier - Bulk List Cleaning, MX & Disposable Checks", "description": "Clean a bulk email list before you send: paste it, or read a dataset from another run or a CSV, Excel or Google Sheets file. Each address is checked for syntax and a working MX record, and flagged if disposable, a role inbox like info@ or a free provider. It never sends mail. $0.49 per 1,000.", "version": "0.1", "x-build-id": "Ag9X6X71aB2iIBB8t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~email-verification/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-email-verification", "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/dami_studio~email-verification/runs": { "post": { "operationId": "runs-sync-dami_studio-email-verification", "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/dami_studio~email-verification/run-sync": { "post": { "operationId": "run-sync-dami_studio-email-verification", "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", "type": "array", "description": "Email addresses to verify. Duplicate addresses are normalized and processed once. Leave empty to run the free sample row.", "items": { "type": "string" } }, "inputDatasetId": { "title": "Addresses from a dataset", "type": "string", "description": "Optional. Pick the dataset of an earlier run, for example the results of another actor, and the addresses in it are checked as well. It is read a page at a time. Name the field that holds the addresses below, or leave that empty to use the fields with \"mail\" in their name." }, "fileUrl": { "title": "Addresses from a CSV or Excel file", "type": "string", "description": "Optional. Upload a CSV or Excel (.xlsx) file, or paste a link to one, or a Google Sheets link. A Google Sheet must be shared as \"Anyone with the link can view\". Only the first sheet of an Excel file is read, and files over 5 MB are refused." }, "emailField": { "title": "Field or column with the addresses", "type": "string", "description": "Optional. The dataset field (such as email, or contact.email for one inside another) or the file's column heading that holds the addresses. Leave empty to use the fields or columns with \"mail\" in their name; a file with no such column is searched cell by cell." }, "maxItems": { "title": "Maximum addresses", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Optional. Stop after this many different addresses, counted across the list, the dataset and the file. Leave empty to check the whole pasted list; a dataset or a file adds at most 100,000 addresses to a run either way." }, "checkSmtp": { "title": "Attempt bounded SMTP probe", "type": "boolean", "description": "Attempt a short SMTP EHLO/MAIL FROM/RCPT TO probe against the first MX host. SMTP is best-effort: many providers block enumeration and Apify cloud may block outbound port 25, so inconclusive is reported rather than treated as invalid.", "default": false }, "smtpTimeoutMs": { "title": "SMTP timeout (milliseconds)", "minimum": 1000, "maximum": 8000, "type": "integer", "description": "Per-connection SMTP deadline. It is capped at 8000 ms to keep cloud runs bounded.", "default": 5000 }, "maxConcurrency": { "title": "Concurrent checks", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum number of email checks running at once. Lower this for conservative DNS and SMTP traffic.", "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 }, "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 } } } } } } } } } }