Cómo cambiar
Empieza por estos tres cambios. A continuación encontrarás los detalles y algunos ejemplos de solicitudes.
-
1 Obtener una clave APICrea tu cuenta de Emailable y genera una clave API desde el panel de control. Utiliza una clave de prueba mientras lo conectas todo; las solicitudes de prueba no consumen créditos.
-
2 Actualizar el punto finalEnvía la dirección de email y tu clave API en una sola solicitud
GET. No necesitarás un parámetro de dirección IP ni puntos finales distintos para las diferentes verificaciones. -
3 Asignar los campos de respuestaEl
statusde ZeroBounce pasa a serstateysub_statuspasa a serreason. La mayoría de los demás campos se corresponden uno a uno.
Actualiza tu integración con la API
Compara los formatos de solicitud y respuesta y, a continuación, actualiza los campos que utiliza tu aplicación.
Solicitud de ZeroBounce
curl "https://api.zerobounce.net/v2/validate?email=john.doe@zerobounce.net&api_key=your_api_key&ip_address="Respuesta de ZeroBounce
{
"address": "john.doe@zerobounce.net",
"status": "valid",
"sub_status": "",
"free_email": false,
"catchall_domain": true,
"did_you_mean": null,
"account": "johndoe",
"domain": "zerobounce.net",
"domain_age_days": "3431",
"active_in_days": "30",
"active_first_seen": "2026-02-25",
"smtp_provider": "g-suite",
"mx_found": "true",
"mx_record": "aspmx.l.google.com",
"firstname": "dan",
"lastname": "cotet",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2026-06-18 07:05:00.033"
}Solicitud de Emailable
curl "https://api.emailable.com/v1/verify?email=support@example.com&api_key=your_api_key"Respuesta de Emailable
{
"accept_all": false,
"did_you_mean": null,
"disposable": false,
"domain": "example.com",
"duration": 0.493,
"email": "support@example.com",
"first_name": null,
"free": false,
"full_name": null,
"gender": null,
"last_name": null,
"mailbox_full": false,
"mx_record": "mx.example.com",
"no_reply": false,
"reason": "accepted_email",
"role": true,
"score": 100,
"smtp_provider": null,
"state": "deliverable",
"tag": null,
"user": "support"
}Solicitud de ZeroBounce
curl -X POST "https://api.zerobounce.net/v2/validatebatch" \
-H "Content-Type: application/json" \
-d '{
"api_key": "your_api_key",
"email_batch": [
{ "email_address": "john.doe@zerobounce.net", "ip_address": "1.1.1.1" },
{ "email_address": "invalid@example.com", "ip_address": "1.1.1.1" },
{ "email_address": "disposable@example.com", "ip_address": null }
],
"activity_data": true,
"verify_plus": true
}'Respuesta de ZeroBounce
{
"email_batch": [
{
"address": "john.doe@zerobounce.net",
"status": "valid",
"sub_status": "",
"free_email": false,
"catchall_domain": true,
"did_you_mean": null,
"account": "johndoe",
"domain": "zerobounce.net",
"domain_age_days": "3431",
"active_in_days": "30",
"active_first_seen": "2026-02-25",
"smtp_provider": "g-suite",
"mx_found": "true",
"mx_record": "aspmx.l.google.com",
"firstname": "dan",
"lastname": "cotet",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2026-06-18 07:05:00.033"
},
{
"address": "invalid@example.com",
"status": "invalid",
"sub_status": "mailbox_not_found",
"free_email": false,
"did_you_mean": null,
"account": null,
"domain": null,
"domain_age_days": "9692",
"active_in_days": "365",
"active_first_seen": "2026-02-25",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mx.example.com",
"catchall_domain": false,
"firstname": "zero",
"lastname": "bounce",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2020-09-17 17:43:11.830"
},
{
"address": "disposable@example.com",
"status": "do_not_mail",
"sub_status": "disposable",
"free_email": false,
"did_you_mean": null,
"account": null,
"domain": null,
"domain_age_days": "9692",
"active_in_days": "365",
"active_first_seen": "2026-02-25",
"smtp_provider": "example",
"mx_found": "true",
"mx_record": "mx.example.com",
"catchall_domain": false,
"firstname": "zero",
"lastname": "bounce",
"gender": "male",
"country": null,
"region": null,
"city": null,
"zipcode": null,
"processed_at": "2020-09-17 17:43:11.830"
}
],
"errors": []
}Solicitud de Emailable
curl -X POST "https://api.emailable.com/v1/batch" \
-H "Content-Type: application/json" \
-d '{
"api_key": "your_api_key",
"emails": [
"tim@smith.com",
"john@smith.com",
"support@emailable.com"
],
"url": "https://example.com/callback"
}'Respuesta de Emailable
{
"emails": [
{
"accept_all": false,
"did_you_mean": null,
"disposable": false,
"domain": "smith.com",
"email": "tim@smith.com",
"first_name": "Tim",
"free": false,
"full_name": "Tim",
"gender": "male",
"last_name": null,
"mailbox_full": false,
"mx_record": "mx.smith.com",
"no_reply": false,
"reason": "accepted_email",
"role": false,
"score": 100,
"smtp_provider": null,
"state": "deliverable",
"tag": null,
"user": "tim"
},
{
"accept_all": false,
"did_you_mean": null,
"disposable": false,
"domain": "smith.com",
"email": "john@smith.com",
"first_name": "John",
"free": false,
"full_name": "John",
"gender": "male",
"last_name": null,
"mailbox_full": false,
"mx_record": "mx.smith.com",
"no_reply": false,
"reason": "rejected_email",
"role": false,
"score": 0,
"smtp_provider": null,
"state": "undeliverable",
"tag": null,
"user": "john"
},
{
"accept_all": false,
"did_you_mean": null,
"disposable": false,
"domain": "emailable.com",
"email": "support@emailable.com",
"first_name": null,
"free": false,
"full_name": null,
"gender": null,
"last_name": null,
"mailbox_full": false,
"mx_record": "aspmx.l.google.com",
"no_reply": false,
"reason": "low_quality",
"role": true,
"score": 70,
"smtp_provider": "Google",
"state": "risky",
"tag": null,
"user": "support"
}
],
"id": "5cf6dd30093f96d2ac34bb0a",
"message": "Batch verification completed.",
"reason_counts": {
"accepted_email": 1,
"invalid_domain": 0,
"invalid_email": 0,
"invalid_smtp": 0,
"low_deliverability": 0,
"low_quality": 1,
"no_connect": 0,
"rejected_email": 1,
"timeout": 0,
"unavailable_smtp": 0,
"unexpected_error": 0
},
"total_counts": {
"deliverable": 1,
"processed": 3,
"risky": 1,
"total": 3,
"undeliverable": 1,
"unknown": 0,
"duplicate": 0
}
}En qué se diferencian los puntos de conexión por lotes
El punto final por lotes de ZeroBounce mantiene la solicitud abierta hasta que se comprueban todas las direcciones, y su documentación te remite a los puntos finales para archivos masivos cuando se superan las 200 direcciones. La API por lotes de Emailable acepta hasta 50 000 direcciones en la solicitud y puede enviar los resultados a tu URL de devolución de llamada.
Las cuentas Enterprise de Emailable pueden solicitar lotes más grandes contactando con soporte.
Cómo consultar tus resultados
En el caso de los lotes de la API, utiliza el ID devuelto para comprobar el estado, o añade una URL de devolución de llamada y te avisaremos a través de tu aplicación cuando haya finalizado el proceso. Los lotes con más de 1.000 direcciones devuelven un enlace de descarga en formato CSV.
curl "https://api.emailable.com/v1/batch?id=5cf6dd30093f96d2ac34bb0a&api_key=your_api_key"For batches up to 1,000 addresses, add partial=true to the status request to read results while the batch is still verifying.
Listas puntuales
Si se trata de una lista de email única, no utilices la API por lotes y recurre al «Bulk Verifier» en tu panel de control de Emailable. Sube el archivo allí y, cuando haya terminado, exporta los resultados.
Relaciona las respuestas
La mayor parte de los resultados que ofrece ZeroBounce tienen un campo «Emailable» correspondiente. Utiliza estas tablas para ver qué ha cambiado y qué se ha mantenido igual.
Correspondencia de estados
| Estado de ZeroBounce | Estado de Emailable |
|---|---|
valid |
deliverable
|
invalid |
undeliverable
|
catch-all |
risky
|
do_not_mail |
risky
|
abuse |
|
spamtrap |
|
unknown |
unknown
|
Un guión significa que no hay un estado «Emailable» que coincida. Utiliza la puntuación y los indicadores de riesgo para decidir cómo debe gestionar tu aplicación esas direcciones.
No existe un estado equivalente
Spam trap lists are kept secret, so no verifier can identify them reliably. Read how to protect your list.
Asignar los campos de respuesta
| Campo de ZeroBounce | Campo de Emailable |
|---|---|
address |
email |
status |
state |
sub_status |
reason |
account |
user |
domain |
domain |
did_you_mean |
did_you_mean |
free_email |
free |
catchall_domain |
accept_all |
smtp_provider |
smtp_provider |
mx_record |
mx_record |
firstname |
first_name |
lastname |
last_name |
gender |
gender |
Emailable también devuelve estos campos, que no tienen equivalente en « ZeroBounce »:
score
role
disposable
mailbox_full
no_reply
tag
Prueba antes de cambiar
Conecta primero tu integración con una clave de prueba. Las direcciones de prueba de Emailable devuelven resultados fijos, por lo que puedes probar todos los estados y atributos antes de poner el sistema en producción sin utilizar créditos.
