{
  "openapi": "3.0.1",
  "info": {
    "title": "Bulk Email Verifier & Finder - Mailbox Exists, SPF/DKIM/DMARC",
    "description": "Bulk email verifier & finder: live mailbox check (accepted/rejected/catch-all), SPF/DKIM/DMARC, spam-trap & blacklist, typo fix, find emails by name+company. Pay only for definitive results.",
    "version": "1.5",
    "x-build-id": "lgfHHEZ8HdCxB9m6j"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/apivault_labs~email-deliverability-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-apivault_labs-email-deliverability-checker",
        "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-deliverability-checker/runs": {
      "post": {
        "operationId": "runs-sync-apivault_labs-email-deliverability-checker",
        "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-deliverability-checker/run-sync": {
      "post": {
        "operationId": "run-sync-apivault_labs-email-deliverability-checker",
        "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 (to verify)",
            "type": "array",
            "description": "Email addresses to verify (one per line), e.g. john.doe@acme.com. Leave empty if you are using 'people' to find emails.",
            "items": {
              "type": "string"
            }
          },
          "people": {
            "title": "Find emails by name + domain (optional)",
            "type": "array",
            "description": "Email FINDER mode. Provide people as objects like [{\"name\":\"John Doe\",\"domain\":\"acme.com\"}] (or use firstName/lastName). The Actor tries common patterns and returns the address the mail server accepts. Extra fields you include are passed through to the output."
          },
          "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."
          },
          "records": {
            "title": "…or records with extra columns (CSV passthrough)",
            "type": "array",
            "description": "Optional. Array of objects each carrying an email field plus any other columns, e.g. [{\"email\":\"a@x.com\",\"name\":\"Ann\",\"crmId\":7}]. All extra columns are passed through to the output - ideal for verifying CRM/CSV exports."
          },
          "emailColumn": {
            "title": "Email column name (for records)",
            "type": "string",
            "description": "Which field in your records holds the email address (default: email).",
            "default": "email"
          },
          "checkMx": {
            "title": "Check domain deliverability (MX / DNS)",
            "type": "boolean",
            "description": "Look up each domain's MX records over DNS-over-HTTPS to confirm it can receive mail and detect the mail provider. Turn off for a pure offline syntax-only pass (faster).",
            "default": true
          },
          "deepCheck": {
            "title": "Deep check: sender auth (SPF/DKIM/DMARC) + Gravatar",
            "type": "boolean",
            "description": "Audit each domain's email authentication (SPF, DKIM, DMARC) over DNS, and check whether the address has a public Gravatar (a real, used-identity signal). Adds a few lookups per address.",
            "default": true
          },
          "verifyMailbox": {
            "title": "Live mailbox check (does the mailbox exist?)",
            "type": "boolean",
            "description": "Confirm at the mail server whether each mailbox actually accepts mail - returns accepted / rejected / catch-all / disposable. This is the real existence check. Checks run in parallel across different domains while each single domain is paced politely (see Live-check parallel workers), so large multi-domain lists are processed quickly. Turn off for a fast domain-only pass.",
            "default": true
          },
          "proxyFallback": {
            "title": "Auto-fallback to proxy if the live check is blocked",
            "type": "boolean",
            "description": "Run the live mailbox check directly first; if it gets rate-limited or blocked, automatically switch to a standard (datacenter) proxy and retry. No proxy is used while direct works.",
            "default": true
          },
          "resolveCatchAll": {
            "title": "Resolve catch-all domains (extra probe)",
            "type": "boolean",
            "description": "When a domain looks catch-all, probe a guaranteed-fake address on the same domain. If the server rejects the fake but accepts the real one, the address is upgraded to valid. Adds one cached check per catch-all domain.",
            "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": "If on, keep only addresses whose status is valid or risky (drops invalid/undeliverable). Best run right before sending.",
            "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"
          },
          "cacheDays": {
            "title": "Don't re-charge for emails verified in the last N days",
            "minimum": 0,
            "maximum": 90,
            "type": "integer",
            "description": "If > 0, results are remembered in a private key-value store. Re-verifying the same address within this many days returns the cached verdict instantly and is NOT charged — you never pay twice for the same email. 0 = always re-check fresh.",
            "default": 0
          },
          "greylistRetries": {
            "title": "Greylisting retries (convert 'unknown' to a verdict)",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Many mail servers return a temporary failure on first contact (greylisting). Retry addresses that came back 'unknown' after a short backoff to turn them into a definitive valid/invalid verdict — more accuracy. 0 = no retry.",
            "default": 1
          },
          "greylistBackoffSecs": {
            "title": "Greylisting retry backoff (seconds)",
            "minimum": 5,
            "maximum": 300,
            "type": "integer",
            "description": "How long to wait before each greylisting retry pass.",
            "default": 30
          },
          "mailboxConcurrency": {
            "title": "Live-check parallel workers (0 = auto)",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Mailboxes are checked in parallel across DIFFERENT domains while each single domain is paced (never hammered). 0 = AUTO: the Actor scales workers with the number of distinct domains in your list — big multi-domain lists run much faster automatically. Set a fixed 1-10 to override (each worker uses its own proxy IP). 1 = slowest/sequential.",
            "default": 0
          },
          "autoCorrect": {
            "title": "Auto-verify typo corrections",
            "type": "boolean",
            "description": "When an address looks like a typo (e.g. gmial.con) and isn't valid, also live-check the suggested correction and report it in `correctedEmail` if the fixed mailbox exists.",
            "default": true
          },
          "fileUrl": {
            "title": "Email list file URL (CSV / TSV / text)",
            "type": "string",
            "description": "Optional. A public URL to a CSV / TSV / plain-text file; every email address found in it is added to the list and de-duplicated. (For XLSX, export to CSV first.)"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}