{ "openapi": "3.0.1", "info": { "title": "Email Validator — From $0.6/1K · MX, SPF & DMARC Checks", "description": "Check email syntax, DNS/MX and disposable signals; optional SMTP observations do not guarantee deliverability. Bulk export: JSON, CSV, Excel and API. PPE: from $0.6/1K email results; start fee, usage extra.", "version": "1.1", "x-build-id": "GxzaZCRTIKLWvxxNx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~email-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-email-validator", "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/apivault_labs~email-validator/runs": { "post": { "operationId": "runs-sync-apivault_labs-email-validator", "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/apivault_labs~email-validator/run-sync": { "post": { "operationId": "run-sync-apivault_labs-email-validator", "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", "maxItems": 10000, "type": "array", "description": "Email addresses to validate (one per line), e.g. john.doe@acme.com.", "items": { "type": "string" } }, "emailsText": { "title": "…or paste a list / CSV column", "type": "string", "description": "Optional. Paste many addresses at once (one per line, or comma/semicolon separated — e.g. a copied spreadsheet column). They are merged with the list above and de-duplicated." }, "emailsFile": { "title": "…or upload a CSV/TXT file", "type": "string", "description": "UTF-8 single-column text/CSV: native public HTTPS upload URL (including signed Apify record URLs), raw text or JSON keyValueStoreId/key reference. For JSON references select emailsFileStoreId to grant READ access. Max 2 MB." }, "findEmails": { "title": "Email Finder — find an address from name + domain", "maxItems": 10000, "type": "array", "description": "Generate unverified ASCII-name/domain patterns. email remains null until a recipient is accepted and catch-all is explicitly false. No guessed address is presented as found.", "items": { "type": "string" } }, "checkMx": { "title": "Check domain deliverability (MX / DNS)", "type": "boolean", "description": "Public domain DNS observations (MX/SPF/DMARC); DNS cannot establish mailbox existence. Finder always uses DNS.", "default": true }, "smtpVerification": { "title": "Live SMTP mailbox check (verify inbox + catch-all)", "type": "boolean", "description": "Optional SMTP recipient observation: direct port25 or public hosted verifier fallback. Catch-all unknown stays unconfirmed. Network/rate-limit/temporary/policy failures remain unknown; no message DATA is sent.", "default": false }, "proxyUrl": { "title": "Proxy for SMTP verification", "type": "string", "description": "Optional HTTP proxy for hosted-verifier requests only; no effect on direct SMTP. auto uses Apify Residential and incurs extra resource costs. A proxy does not guarantee verification or remove source limits." }, "proxySessions": { "title": "Proxy sessions to rotate", "minimum": 1, "maximum": 30, "type": "integer", "description": "Legacy compatibility field; one hosted-verifier proxy session is used. Known rate limits are not retried with rotating IPs.", "default": 1 }, "smtpTimeout": { "title": "SMTP timeout (seconds)", "minimum": 4, "maximum": 30, "type": "integer", "description": "Per-step timeout for the SMTP mailbox check.", "default": 10 }, "freshDisposableList": { "title": "Use full disposable-domain list (18k+ domains)", "type": "boolean", "description": "Refresh public disposable-domain lists once per run. Falls back to built-in entries if unavailable; SUMMARY reports actual entry count, not complete disposable coverage.", "default": true }, "deduplicate": { "title": "De-duplicate addresses", "type": "boolean", "description": "Remove duplicate addresses using provider-aware normalization (Gmail dots and +tags are ignored). Keeps the first occurrence.", "default": true }, "onlyValid": { "title": "Return only syntactically valid emails", "type": "boolean", "description": "If on, drop addresses that fail the syntax check from the output.", "default": false }, "onlyDeliverable": { "title": "Return only deliverable emails", "type": "boolean", "description": "Strictly keep rows with technical_status valid / SMTP recipient accepted / catchAll false. DNS-only and unknown rows are excluded. This is an observation, not a delivery guarantee.", "default": false }, "dropDisposable": { "title": "Drop disposable / throwaway emails", "type": "boolean", "description": "If on, remove addresses on known temporary-mailbox domains.", "default": false }, "dropRoleBased": { "title": "Drop role-based emails", "type": "boolean", "description": "If on, remove group mailboxes like info@, sales@, support@ (keep only personal addresses).", "default": false }, "exportFormat": { "title": "Export format", "enum": [ "default", "csv", "both" ], "type": "string", "description": "default = full JSON. csv = flat CSV-friendly columns. both = JSON + nested _csv.", "default": "default" }, "maxResults": { "title": "maxResults", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Delivered row cap including finder rows.", "default": 100 }, "maxConcurrency": { "title": "maxConcurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Concurrent rows (source requests are coalesced per domain).", "default": 5 }, "emailsFileStoreId": { "title": "Uploaded file key-value store", "type": "string", "description": "For a JSON KV file reference, select its store to grant read-only access under Limited permissions. Native upload URLs can be read directly when accessible." } } }, "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 } } } } } } } } } }