{ "openapi": "3.0.1", "info": { "title": "Email List Cleaner", "description": "Clean an email list before you import it. Removes malformed addresses and dead domains, flags disposable inboxes and shared role addresses, fixes obvious typos, and drops duplicates, so you stop paying to send to addresses that were never going to land.", "version": "0.1", "x-build-id": "zW2ec8yA2DgAfeKTQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~email-list-cleaner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-email-list-cleaner", "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/arched_friend~email-list-cleaner/runs": { "post": { "operationId": "runs-sync-arched_friend-email-list-cleaner", "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/arched_friend~email-list-cleaner/run-sync": { "post": { "operationId": "run-sync-arched_friend-email-list-cleaner", "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", "required": [ "emails" ], "properties": { "emails": { "title": "Email addresses", "type": "array", "description": "The addresses to verify. Paste a list, or feed it straight from another Actor's output.", "items": { "type": "string" } }, "checkSmtp": { "title": "Also ask the mail server (needs port 25)", "type": "boolean", "description": "Opens a conversation with the mail server to confirm the mailbox exists, without sending anything. Off by default because it needs outbound port 25, which Apify and most cloud platforms block. Turn it on only where you know port 25 is open.", "default": false }, "checkCatchAll": { "title": "Detect catch all domains", "type": "boolean", "description": "Also asks about an address nobody owns. A domain that accepts that accepts everything, so a positive answer there means nothing and is reported as risky rather than valid.", "default": true }, "dropDuplicates": { "title": "Drop duplicates", "type": "boolean", "description": "Removes repeated addresses before verifying, so you are not charged twice for the same one.", "default": true }, "onlyDeliverable": { "title": "Return sendable addresses only", "type": "boolean", "description": "Keeps only the addresses worth sending to and drops the rest from the output.", "default": false }, "includeUnknown": { "title": "Count unknown as sendable", "type": "boolean", "description": "Large providers refuse to confirm a mailbox. Those come back as unknown, and most senders still mail them.", "default": true }, "includeRisky": { "title": "Count risky as sendable", "type": "boolean", "description": "Includes role addresses, disposable inboxes and catch all domains. Off by default, because these are what damage a sending reputation.", "default": false }, "concurrency": { "title": "Domains checked at once", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many domains to work through in parallel. Lower this if a mail server starts rate limiting.", "default": 5 }, "smtpTimeoutSecs": { "title": "Mail server timeout", "minimum": 3, "maximum": 60, "type": "integer", "description": "How long to wait for a mail server before giving up and reporting unknown.", "default": 10 }, "fromEmail": { "title": "Probe sender address", "type": "string", "description": "The address the probe identifies itself with. Empty uses the null sender, which is what a bounce message uses. Supplying an address on a domain you own can improve answers from strict servers." }, "heloName": { "title": "HELO name", "type": "string", "description": "The hostname the probe introduces itself as. Some strict servers prefer a real one.", "default": "verifier.local" } } }, "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 } } } } } } } } } }