{ "openapi": "3.0.1", "info": { "title": "Bulk Email Verifier — CSV, Excel & List Cleaning", "description": "Upload a CSV or Excel file, paste a list, or chain another Actor's dataset — every address is sorted into valid, invalid or risky. Checks syntax, mail servers, disposable providers, role accounts and domain typos, and reports exactly which checks it could run.", "version": "0.1", "x-build-id": "1giEv9gFIHpaXEDCc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mxxiv~email-verifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mxxiv-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/mxxiv~email-verifier/runs": { "post": { "operationId": "runs-sync-mxxiv-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/mxxiv~email-verifier/run-sync": { "post": { "operationId": "run-sync-mxxiv-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", "type": "array", "description": "Addresses to verify, one per item. Accepts plain strings, or objects with an \"email\" field so output from another Actor can be piped straight in.", "items": { "type": "string" } }, "emailsRaw": { "title": "Paste a list instead", "type": "string", "description": "Paste addresses separated by newlines, commas or semicolons. Merged with the list above and de-duplicated." }, "inputDatasetId": { "title": "Verify another Actor's dataset", "type": "string", "description": "Pick a dataset from a previous run — typically a lead scraper's output. Every item is scanned and its email addresses verified, so you can chain this Actor straight onto a scraper without exporting anything. Leave the field name blank and common keys (email, work_email, contactEmail, …) are detected automatically." }, "fileUrl": { "title": "CSV or Excel file", "type": "string", "description": "Upload a .csv or .xlsx file, or paste a link to one. The address column is detected from its header; a single column of addresses with no header works too." }, "emailField": { "title": "Address field name (optional)", "type": "string", "description": "Name of the dataset field or spreadsheet column holding the address, e.g. \"work_email\". Leave blank to auto-detect. Applies to both the dataset and the file above." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many addresses to verify in parallel. Lookups for the same domain are cached and never duplicated, so large lists at few domains stay cheap.", "default": 20 }, "enableSmtpCheck": { "title": "Attempt SMTP mailbox probe (usually unavailable)", "type": "boolean", "description": "Tries to confirm the individual mailbox by talking to the mail server on port 25. The Apify platform blocks outbound port 25, as do most clouds and many ISPs, so this normally cannot connect and results fall back to domain-level verification with smtpChecked=false. Leave off unless you are running this Actor somewhere with port 25 open.", "default": false }, "detectCatchAll": { "title": "Detect catch-all domains", "type": "boolean", "description": "When the SMTP probe is available, also test a random address at the same domain. If that is accepted too, the domain accepts everything and the result is reported as risky rather than valid.", "default": true }, "smtpTimeoutSeconds": { "title": "SMTP timeout (seconds)", "minimum": 3, "maximum": 60, "type": "integer", "description": "How long to wait for the mail server before giving up on the probe.", "default": 10 }, "heloDomain": { "title": "HELO domain", "type": "string", "description": "Domain announced during the SMTP handshake. Some mail servers reject probes whose HELO domain does not resolve.", "default": "example.com" }, "mailFrom": { "title": "MAIL FROM address", "type": "string", "description": "Envelope sender used during the SMTP probe. No message is ever sent — the transaction stops before DATA.", "default": "verify@example.com" } } }, "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 } } } } } } } } } }