{
  "openapi": "3.0.1",
  "info": {
    "title": "Smart Email Finder & Verifier — Website + DNS",
    "description": "Find published company website emails from domains or CSV. Check syntax, DNS mail routing, mail provider, SPF, DMARC and selected DKIM records; preserve source pages and address flags. Also check an existing email list. Mailbox existence stays unknown.",
    "version": "1.1",
    "x-build-id": "Ai88Gy8UPY8WA5UKN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~smart-email-finder-verifier/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-smart-email-finder-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/khadinakbar~smart-email-finder-verifier/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-smart-email-finder-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/khadinakbar~smart-email-finder-verifier/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-smart-email-finder-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": {
          "websites": {
            "title": "Company websites or domains",
            "type": "array",
            "description": "Use this to find published company contact emails. Enter domains or public HTTP/HTTPS URLs, such as python.org/about/help/. Supply up to 100 websites; the first URL for each domain is used. Contact links are prioritized and robots.txt is respected.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Discovery or verification",
            "enum": [
              "find",
              "verify"
            ],
            "type": "string",
            "description": "Choose find for website discovery or verify for supplied addresses. For example, use verify with the emails list. The default is find. Verification checks syntax and DNS routing while mailbox existence remains unknown.",
            "default": "find"
          },
          "emails": {
            "title": "Email addresses to check",
            "type": "array",
            "description": "Use this in verify mode for an existing address list. Enter strings such as sales@example.org. Up to 5,000 inputs are accepted and maxResults bounds processing. Invalid addresses receive a result with reason codes.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxWebsites": {
            "title": "Maximum websites",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Limit company domains processed. For example, set maxWebsites to 10. The default is 10, with bounds 1–100. A global result or billing limit may stop work earlier.",
            "default": 10
          },
          "maxPagesPerWebsite": {
            "title": "Pages per website",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Limit HTML pages attempted per website. For example, set maxPagesPerWebsite to 5. The default is 5, with bounds 1–20. A global result or billing limit may stop work earlier.",
            "default": 5
          },
          "maxResults": {
            "title": "Maximum dataset rows",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Limit total email and diagnostic rows. For example, set maxResults to 100. The default is 100, with bounds 1–1000. A global result or billing limit may stop work earlier.",
            "default": 100
          },
          "maxConcurrency": {
            "title": "Concurrent websites or checks",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Limit simultaneous website crawls or address checks. For example, set maxConcurrency to 3. The default is 3, with bounds 1–10. A global result or billing limit may stop work earlier.",
            "default": 3
          },
          "requestTimeoutSecs": {
            "title": "Request timeout in seconds",
            "minimum": 5,
            "maximum": 45,
            "type": "integer",
            "description": "Limit seconds per website request including DNS and redirects. For example, set requestTimeoutSecs to 15. The default is 15, with bounds 5–45. A global result or billing limit may stop work earlier.",
            "default": 15
          },
          "includeExternalEmails": {
            "title": "Include published emails on other domains",
            "type": "boolean",
            "description": "Keep published addresses whose domain differs from the website. For example, a business may publish a Gmail address. Enabled by default and flagged with isExternal. Source pages remain attached for review.",
            "default": true
          },
          "includeRoleEmails": {
            "title": "Include role and department addresses",
            "type": "boolean",
            "description": "Keep role addresses such as info, sales and support. For example, sales@example.org is marked isRoleBased. Enabled by default. Disable to focus discovery on other published addresses.",
            "default": true
          },
          "csvUrl": {
            "title": "Public website CSV URL",
            "type": "string",
            "description": "Import company websites from a public UTF-8 CSV file. For example, use https://example.org/companies.csv with a website header. The file is bounded to 2 MB and 1,000 rows. Use ordinary public URLs; credentials, signed query strings and cross-host redirects are outside this input contract.",
            "default": ""
          },
          "csvColumn": {
            "title": "Website CSV column",
            "type": "string",
            "description": "Select the CSV header containing websites. For example, use website or company_url. The default is website and column names are case-sensitive. Only website values are imported; other CSV columns are discarded.",
            "default": "website"
          },
          "includeAuthenticationChecks": {
            "title": "Include domain authentication records",
            "type": "boolean",
            "description": "Inspect SPF, DMARC and selected DKIM records through DNS. For example, enable this to review a company domain alongside its email contacts. Enabled by default with per-run domain caching. These are domain-authentication observations, not proof that a specific mailbox exists or that signatures will validate.",
            "default": true
          },
          "dkimSelectors": {
            "title": "DKIM selectors to inspect",
            "type": "array",
            "description": "Inspect these DKIM selector labels for each email domain. For example, google queries google._domainkey.example.org. Supply up to 10 distinct DNS labels, or an empty list for SPF and DMARC only. A missing selector does not prove that the domain has no DKIM configuration.",
            "default": [
              "default",
              "google",
              "selector1",
              "selector2",
              "s1",
              "s2",
              "k1"
            ],
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}