Domain Search API (V2)

Domain search is functionally similar to email address inquiry but instead attempts to detect possible patterns a specific company uses. You can use detected patterns to help you approximate the correct email for a specific person you’re attempting to contact at a business.

Privacy and security note – Domain Search API searches are performed in real time and do not use stored or processed customer data. Customer privacy and security are and will always remain our top priority.

How to use the Domain Search API

Domain search only requires the domain or company name – no first or last name is necessary.

Before you begin, ensure that your account has enough credits or subscription queries. A successful domain search will consume one (1) subscription query or 20 credits.

If the response is undetermined, no credits or queries will be deducted.

To use the Email Finderⓘ API, use the following URL, method, and parameters. Be sure to review the successful response example below and response details to ensure your API configuration works correctly.

API DEFAULT URL: https://api.zerobounce.net/v2/guessformat

API U.S.A. URL*: https://api-us.zerobounce.net/v2/guessformat

API EU URL: https://api-eu.zerobounce.net/v2/guessformat

Method: GET

*This endpoint uses servers located within the United States. By using this endpoint, you acknowledge and consent to your data being processed on servers in the United States.

Note: Either the “domain” or the “company_name” must be entered

Successful Response

      {
        "domain": "example.com",
        "company_name": "Example Company LLC",
        "format":"first.last",
        "confidence": "high",
        "did_you_mean": "",
        "did_you_mean": "",
        "failure_reason": "",
        "other_domain_formats": [
            {
                "format": "first",
                "confidence": "high"
            },
            {
                "format": "last.first",
                "confidence": "high"
            },
            {
                "format": "lastfirst",
                "confidence": "high"
            }
        ]
      }

Response Details

Code Samples

Possible failure reasons for unknown status

Other potential error messages

      {
        "Message": "Invalid API key or your account ran out of credits"
      }

You can resolve this error by ensuring that there is at least one (1) subscription query or 20 ZeroBounce credits in your account balance before making your next API call. Additionally, ensure that the API key is valid.

Domain Search API confidence levels

For each format, the Domain Search API identifies, we assign a corresponding confidence level to indicate the probability that the address is actively used in the respective email domain.

The confidence levels are listed below:

• LOW - unlikely to be in use; high-risk
• MEDIUM - medium level of confidence; the format may be in use
• HIGH - highest level of confidence, format likely in use based on validation results
• UNKNOWN - see above section for possible unknown errors
• UNDETERMINED - cannot determine email, so format is unknown. Confidence for an empty email cannot be determined.

If you need further assistance configuring the Domain Search API or need help to understand your results, the ZeroBounce customer support team is available 24/7.