API de búsqueda de dominio (V2)

La búsqueda de dominios es funcionalmente similar a la consulta de direcciones de correo electrónico, pero en su lugar intenta detectar posibles patrones que utiliza una empresa específica. Puede usar patrones detectados para aproximarse al correo electrónico correcto de una persona concreta con la que intenta ponerse en contacto en una empresa.

Nota de privacidad y seguridad : Las búsquedas de la API de búsqueda de dominios se realizan en tiempo real y no utilizan datos de clientes almacenados o procesados. La privacidad y la seguridad del cliente son y seguirán siendo siempre nuestra máxima prioridad.

Cómo usar la API de búsqueda de dominios

La búsqueda de dominios solo requiere el nombre del dominio o de la empresa, no es necesario ni el nombre ni el apellido.

Antes de comenzar, asegúrese de que su cuenta tenga suficientes créditos o consultas de suscripción. Una búsqueda de dominio exitosa consumirá una (1) consulta de suscripción o 20 créditos.

Si la respuesta es indeterminada, no se deducirán créditos ni consultas.

Para utilizar la API del Buscador de correo electrónico, utilice la siguiente URL, método y parámetros. Asegúrese de consultar el ejemplo de respuesta correcta que aparece a continuación y los detalles de la respuesta para asegurarse de que la configuración de su API funciona correctamente.

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

Método: GET

*Este punto de conexión utiliza servidores ubicados dentro de los Estados Unidos. Al utilizar este punto de conexión, usted reconoce y da su consentimiento para que sus datos se procesen en servidores en los Estados Unidos.

  • Parámetro
    Obligatorio
    Descripción
  • api_key
    Sí
    Su clave API, que se encuentra en su cuenta.
  • domain
    Sí
    El dominio de correo electrónico para el que quiere encontrar el formato de correo electrónico.
  • company_name
    Sí
    El nombre de la empresa para la cual buscar el formato de correo electrónico.

Nota: Se debe introducir el "domain" o el "company_name"

Respuesta exitosa


      {
        "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"
            }
        ]
      }

Detalles de la respuesta

  • Propiedades
    Descripción
  • domain
    El nombre de dominio proporcionado.
  • company_name
    La empresa asociada al dominio.
  • format
    El formato de las direcciones de correo electrónico resultantes
  • confidence
    El nivel de confianza que tenemos en el formato proporcionado basado en nuestro motor y base de datos. Valores posibles: BAJO, MEDIO, ALTO, DESCONOCIDO
  • did_you_mean
    Por ejemplo, una sugerencia en caso de que se utilice un nombre en el campo apellido.
  • failure_reason
    useEmailFinderAPIresponse_Description_Failure_Reason
  • other_domain_formats
    Una lista de formatos de dominio que tenemos para el dominio especificado. Esta lista contiene otros formatos (por ejemplo, nombre, nombre_apellido, nombre.apellido, etc.) y el nivel de confianza que tenemos en el formato correspondiente.

Ejemplos de código

Posibles causas de error por estado desconocido

  • Causa
    Descripción
  • FREE_DOMAIN_ERROR
    No se puede encontrar el patrón para dominios gratuitos
  • DOMAIN_SYNTAX_ERROR
    Error de sintaxis de dominio
  • COMPANY_DOMAIN_ERROR
    Se debe ingresar el dominio o el nombre de la empresa
  • COMPANY_DOMAIN_NOT_FOUND
    No hay ningún dominio asignado para este nombre de empresa
  • UNEXPECTED_ERROR_OCCURRED_DURING_VALIDATION
    Se ha producido un error inesperado durante la validación
  • DOMAIN_DOES_NOT_ACCEPT_MAIL
    El dominio no acepta correo
  • NO_DATA_FOR_THIS_DOMAIN
    No hay datos para este dominio
  • NO_DATA_FOR_THIS_COMPANY
    No hay datos para esta empresa

Otros posibles mensajes de error


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

Puede resolver este error asegurándose de que haya al menos una (1) consulta de suscripción u 20 créditos de ZeroBounce en el saldo de su cuenta antes de realizar su próxima llamada a la API. Además, asegúrese de que la clave de API sea válida.

Niveles de confianza de la API de búsqueda de dominio

Para cada formato que identifica la API de búsqueda de dominios, asignamos un nivel de confianza correspondiente para indicar la probabilidad de que la dirección se utilice activamente en el dominio de correo electrónico respectivo.

A continuación se indican los niveles de confianza:

  • BAJO: poco probable que esté en uso; de alto riesgo
  • MEDIO: nivel medio de confianza; El formato puede estar en uso
  • ALTO: el nivel de confianza más alto, formato probablemente en uso en función de los resultados de validación
  • DESCONOCIDO: consulte la sección anterior para posibles errores desconocidos
  • INDEFINIDO: no se puede determinar el correo electrónico, por lo que se desconoce el formato. No se puede determinar la confianza de un correo electrónico vacío.

Si necesita más ayuda para configurar la API de búsqueda de dominios o para comprender sus resultados, el equipo de atención al cliente de ZeroBounce está disponible las 24 horas, los 7 días de la semana.