{
"openapi": "3.0.1",
"info": {
"title": "Bulk Email Verifier - MX, Disposable, Role & Deliverability",
"description": "Clean an email list before you send. Get MX deliverability, disposable and role flags, provider ID, typo fixes and an optional SMTP check as a status and 0-100 score.",
"version": "0.1",
"x-build-id": "hJnoEEDh9PrXB8nDA"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~bulk-email-verifier/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~bulk-email-verifier/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~bulk-email-verifier/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": "Emails",
"type": "array",
"description": "Email addresses to verify, one per line. Duplicates are collapsed and addresses are lower-cased. Leave empty and the run returns a small free sample so you can see the output shape at no cost.",
"items": {
"type": "string"
}
},
"emailsFromFile": {
"title": "Import emails from a file (one per line)",
"type": "string",
"description": "Bulk-load addresses. Either paste the whole list (one per line or comma-separated), or give a single link to a public .txt/.csv, a Google Sheet or Drive share link, or an Apify key-value-store record. Blank lines, # comments, CRLF, a UTF-8 BOM, quotes and extra CSV columns all parse. A file that cannot be read stops the run with a clear message and charges nothing."
},
"smtpCheck": {
"title": "Attempt SMTP mailbox check (best-effort)",
"type": "boolean",
"description": "Additionally try a live SMTP handshake to confirm the specific mailbox exists. Most cloud platforms block outbound SMTP (port 25), so this is best-effort: when it is available it upgrades a result to a confirmed mailbox, and when it is not it degrades silently to the DNS/MX verdict. It never fails a row. Leave off for the fastest run.",
"default": false
},
"concurrency": {
"title": "Concurrency",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "How many addresses to check in parallel. DNS checks are light, so 20 is a good default; lower it only if you enable the SMTP check against a strict mail host.",
"default": 20
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports. Nothing to memorise: open the dropdown and tick, or start typing (status, mx, disposable) to filter.",
"items": {
"type": "string",
"enum": [
"type",
"email",
"normalizedEmail",
"localPart",
"domain",
"status",
"score",
"formatValid",
"mxFound",
"mxHost",
"mailProvider",
"isDisposable",
"isRoleBased",
"isFreeProvider",
"didYouMean",
"smtpChecked",
"smtpAccepted",
"smtpNote",
"reason",
"checkedAt"
],
"enumTitles": [
"Record type (type)",
"Email (email)",
"Normalized email (normalizedEmail)",
"Local part (localPart)",
"Domain (domain)",
"Status (status)",
"Score 0-100 (score)",
"Format valid (formatValid)",
"MX found (mxFound)",
"MX host (mxHost)",
"Mail provider (mailProvider)",
"Is disposable (isDisposable)",
"Is role-based (isRoleBased)",
"Is free provider (isFreeProvider)",
"Did you mean (didYouMean)",
"SMTP checked (smtpChecked)",
"SMTP accepted (smtpAccepted)",
"SMTP note (smtpNote)",
"Reason (reason)",
"Checked at (checkedAt)"
]
}
},
"maxItems": {
"title": "Max emails",
"minimum": 1,
"type": "integer",
"description": "Maximum number of addresses to verify in one run (after de-duplication).",
"default": 1000
}
}
},
"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
}
}
}
}
}
}
}
}
}
}