VALIDADOR DE CORREO ELECTRÓNICO ÚNICO - EN TIEMPO REAL (V2)

A continuación se encuentran las instrucciones para nuestra API de validación de un solo correo electrónico, que requiere SSL. La API también requiere que tengas un saldo activo de créditos y nunca consumirá un crédito por un resultado desconocido. Este endpoint puede llamarse de forma asíncrona y actualmente no tiene límite de tasa.

Para probar nuestro API sin usar créditos – Por favor use los correos electrónicos proporcionados en nuestro Modo Sandbox (v2)

El tiempo de respuesta de nuestra API está entre uno y treinta segundos. Dado que las API están diseñadas para ser rápidas por naturaleza, limitamos el tiempo que dedicamos a validar una dirección de correo electrónico. Si encontramos un servidor de correo lento o un servidor con un algoritmo de greylisting, obtendrás un resultado desconocido. Siempre puedes volver a validar esas condiciones subiendo un archivo a la validador de correo electrónico masivo..

En promedio, el 96-98% de todos los dominios responderán entre 1 y 5 segundos. Hay algunos dominios que utilizan Postfix/Dovecot, que tienen un tiempo de conexión de 20 segundos para validaciones en tiempo real, y una fracción muy pequeña de otros dominios que responden lentamente a consultas SMTP. Todos los principales ISP responderán entre 1 y 3 segundos, lo cual representa típicamente la mayoría de la distribución de correos electrónicos.

GET /V2/VALIDATE

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/validate

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

URL de la API de la UE: https://api-eu.zerobounce.net/v2/validate

A continuación se encuentran las instrucciones para nuestra API de validación de un solo correo electrónico, que requiere SSL. La API también requiere que tengas un saldo activo de créditos y nunca consumirá un crédito por un resultado desconocido. Este endpoint puede llamarse de forma asíncrona y actualmente no tiene límite de tasa.

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Parámetros URL

  • Parámetro
    Descripción
  • email
    La dirección de correo electrónico que quiere validar.
  • ip_address
    La dirección IP desde la que se registró el correo (Puede estar en blanco, pero se requiere un parámetro)
  • api_key
    Su clave API que se encuentra en su cuenta.
  • tiempo de espera
    La duración (3 - 60 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)
  • activity_data
    [true/false] La información de Activity Data se añadirá al resultado de la validación. (parámetro opcional)
    Más información sobre Activity Data.
  • verify_plus
    [true/false] Si se establece en ‘true’, se utilizará el método de validación Verify+ para obtener el resultado de la validación. Esto anula la configuración de la cuenta con respecto a Verify+. (parámetro opcional)
    Aprende más sobre Verify+.
Si deseas llamar a la API desde tu navegador para probarla, solo necesitas reemplazar la CLAVE API con tu clave:
  • https://api.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145
  • https://api-us.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145
  • https://api-eu.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

PARA VERIFICAR UNA DIRECCIÓN DE CORREO ELECTRÓNICO, UTILICE LOS SIGUIENTES CÓDIGOS PARA LOS SIGUIENTES LENGUAJES:

Respuesta exitosa

    {
        "address":"flowerjill@aol.com",
        "status":"valid",
        "sub_status":"",
        "free_email":true,
        "did_you_mean":null,
        "account":"flowerjill",
        "domain":"aol.com",
        "domain_age_days": "8426",
        "active_in_days": "365",
        "smtp_provider":"yahoo",
        "mx_record":"mx-aol.mail.gm0.yahoodns.net",
        "mx_found": "true",
        "firstname":"Jill",
        "lastname":"Stein",
        "gender":"female",
        "country":"United States",
        "region":"Florida",
        "city":"West Palm Beach",
        "zipcode":"33401",
        "processed_at":"2017-04-01 02:48:02.592"
        }
    
Respuesta de error

    {"error":"Invalid API Key or your account ran out of credits"}
    // Failure response sample using the API with either method Get
    

LA API DEVOLVERÁ ESTOS RESULTADOS EN FORMATO JSON USANDO EL MÉTODO "VALIDATE".

JSON Propiedades

  • Propiedades
    Descripción
  • address
    La dirección de correo electrónico que está validando.
  • status
    [valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail]
  • sub_status
    [alternate, antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic, accept_all]
  • account
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • domain
    La parte de la dirección de correo electrónico después del símbolo "@".
  • did_you_mean
    Solución sugerente para un error tipográfico en el correo electrónico
  • domain_age_days
    Antigüedad del dominio de correo electrónico en días o [nulo].
  • active_in_days
    La última fecha de actividad que es anterior a [30/60/90/180/365/365+]
  • free_email
    [verdadero / falso] Si el correo electrónico proviene de un proveedor gratuito
  • mx_found
    [verdadero / falso] ¿El dominio tiene un registro MX?.
  • mx_record
    El registro MX preferido del dominio
  • smtp_provider
    El proveedor SMTP del correo electrónico o [nulo] [BETA].
  • firstname
    El nombre del propietario del correo electrónico cuando esté disponible o [nulo].
  • lastname
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo].
  • gender
    El sexo del propietario del correo electrónico cuando esté disponible o [nulo].
  • city
    La ciudad de la IP transmitida o [nulo]
  • region
    La región/el estado de la IP transmitida o [nulo]
  • zipcode
    El código postal de la IP transmitida o [nulo]
  • country
    El país de la IP transmitida o [nulo]
  • processed_at
    La hora UTC en que se validó el correo electrónico.

Validación API V2 Límites

Permitimos un máximo de 50,000 solicitudes en 10 segundos (validaciones) para los siguientes endpoints:

  • https://api.zerobounce.net/v2/validate
  • https://api-us.zerobounce.net/v2/validate*
  • https://api-eu.zerobounce.net/v2/validate

Superar este límite resultará en un bloqueo temporal de 1 minuto.

Solicitudes con clave API incorrecta (200 veces en 1 hora) a los siguientes endpoints resultarán en un bloqueo temporal de 1 hora:

  • https://api.zerobounce.net/v2/validate
  • https://api-us.zerobounce.net/v2/validate*
  • https://api-eu.zerobounce.net/v2/validate

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.