{ "openapi": "3.0.1", "info": { "title": "Email Validator: Bulk Email Verification & MX", "description": "Bulk email validator for email verification and list cleaning. Checks syntax, MX records, disposable domains, role addresses, typos like gmial.com, SPF and DMARC. Gives each email a valid, risky or invalid verdict. Uses DNS only. Paste emails, link a CSV file or read another Actor's dataset.", "version": "0.1", "x-build-id": "poips6Jii1Rcqg9kC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maliksaid~email-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maliksaid-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/maliksaid~email-validator/runs": { "post": { "operationId": "runs-sync-maliksaid-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/maliksaid~email-validator/run-sync": { "post": { "operationId": "run-sync-maliksaid-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", "type": "array", "description": "Paste the addresses to check, one per line. You can also paste a comma-separated list. Leave empty to use only the list file or the dataset below. Use only lists you have a lawful basis to process.", "items": { "type": "string" } }, "emailListUrl": { "title": "List file URL (TXT or CSV)", "type": "string", "description": "Read addresses from a TXT or CSV file at this link, for example a Google Sheets CSV export or a file in an Apify key-value store. Every cell that contains @ is checked. Up to 20 MB." }, "datasetId": { "title": "Dataset with email addresses", "type": "string", "description": "Optional. Pick a dataset, for example the output of a lead or contact scraper. The Actor reads the email address from each row and adds datasetId and datasetItemIndex to every result, so you can join them back. It only reads the dataset." }, "datasetEmailField": { "title": "Email field in the dataset", "type": "string", "description": "The field that holds the address, for example email or contact.email. Empty: the Actor uses the first of email, emails, emailAddress, email_address, Email, mail, contactEmail, contactEmails that holds an address. Arrays give one row per address.", "default": "" }, "removeDuplicates": { "title": "Remove duplicates", "type": "boolean", "description": "Skip repeats of an address already in the list. Skipped repeats are not saved and not charged. Turn off to keep every row, with isDuplicate set to true on repeats.", "default": true }, "checkSpfDmarc": { "title": "Check SPF and DMARC", "type": "boolean", "description": "Look up whether each domain publishes SPF and DMARC records. Turn off for a slightly faster run.", "default": true }, "suppressionList": { "title": "Suppression list", "type": "array", "description": "Optional. Addresses or domains you must not email, such as unsubscribes or complaints. Write a full address or a domain like @example.com. Matches get suppressed: true and go to REMOVE_LIST.txt. The list is used for this run only and never stored.", "default": [], "items": { "type": "string" } }, "cleanListIncludesRisky": { "title": "Clean list includes risky addresses", "type": "boolean", "description": "Off: CLEAN_LIST.csv holds valid addresses only. On: it also holds risky ones, such as role addresses.", "default": false }, "maxItems": { "title": "Maximum addresses", "minimum": 0, "type": "integer", "description": "Stop after checking this many addresses. The default keeps test runs short and cheap. Set 0 to check the whole list, up to 200,000 per run.", "default": 100 } } }, "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 } } } } } } } } } }