{ "openapi": "3.0.1", "info": { "title": "Bulk Email Verifier — MX, Disposable & Typo Check", "description": "[$0.70/1K e-mails] Bulk email verifier for lead lists: syntax, live MX lookup, throwaway and role addresses, typo fixes, duplicate spellings, 0-100 score. Paste a list, a CSV or Google Sheet link, or another Actor's dataset. Domain-level check, no mail sent, no run fee.", "version": "0.1", "x-build-id": "xCSuNdkSa4Qm2mPoi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lergassy~bulk-email-verifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lergassy-bulk-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/lergassy~bulk-email-verifier/runs": { "post": { "operationId": "runs-sync-lergassy-bulk-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/lergassy~bulk-email-verifier/run-sync": { "post": { "operationId": "run-sync-lergassy-bulk-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": "📧 E-mail addresses", "type": "array", "description": "Addresses to verify, one per line (a line with several addresses separated by commas also works). Each one is checked for syntax, throwaway and role addresses, typos and duplicate spellings, then the domain's mail servers are looked up live. Through the API you can also pass objects such as {\"email\": \"jane@acme.com\", \"id\": 42} — extra fields are copied to the output row.", "items": { "type": "string" } }, "fileUrl": { "title": "📄 Or a link to a list (CSV, TXT, Google Sheet)", "type": "string", "description": "Public link to a CSV or TXT file, or a Google Sheets link shared as \"anyone with the link can view\". Every e-mail address found anywhere in the file is verified; other columns are not copied. Combine with the field above if you like — repeats are removed." }, "inputDatasetId": { "title": "🔗 Or a dataset from another Actor", "type": "string", "description": "Dataset of a previous run — the lead list you just scraped, for example. The addresses are read straight from it, so you never move data by hand." }, "keep": { "title": "🎯 Keep only", "enum": [ "all", "clean", "deliverable_email", "person_email", "business_email", "unique", "problems" ], "type": "string", "description": "Filter the output instead of filtering rows yourself afterwards. Only the rows that come back are billed, so filtered-out addresses cost nothing.", "default": "all" }, "emailField": { "title": "E-mail field in that dataset", "type": "string", "description": "Which field of the dataset holds the address. Several names can be listed, separated by commas — the first one present wins. A field that holds a list of addresses is expanded.", "default": "email" }, "dnsCheck": { "title": "Look up mail servers (MX)", "type": "boolean", "description": "Ask the domain's name servers whether it accepts mail. Turning this off leaves syntax and list checks only.", "default": true }, "maxEmails": { "title": "Maximum e-mails per run", "minimum": 1, "maximum": 500000, "type": "integer", "description": "Safety cap on how many addresses one run will check.", "default": 50000 }, "concurrency": { "title": "Parallel lookups", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many domains to look up at once.", "default": 20 }, "dnsTimeoutMs": { "title": "Lookup timeout, milliseconds", "minimum": 500, "maximum": 15000, "type": "integer", "description": "How long to wait for a name server before the address is returned as unknown rather than bad. A timeout is retried once with double the budget.", "default": 5000 } } }, "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 } } } } } } } } } }