Analíticas
Estadísticas de entrega pocos segundos después de cada evento, en el panel y con GET /emails/metrics.
Cada resultado (entregado, rebotado, queja, abierto, clic, baja) se cuenta pocos segundos después de producirse. La página Analíticas del panel y GET /emails/metrics leen los mismos números.
En el panel, Analíticas muestra las tasas de entrega, apertura, clics, rebote y quejas, y un gráfico de eventos por hora. Puedes filtrar por intervalo de tiempo (7, 15 o 30 días), zona horaria, marca (dominio de envío), envío masivo y dominio del destinatario.
Las estadísticas se guardan por hora durante 13 meses. El historial de un envío masivo no se corta a los 13 meses. Si el servicio de estadísticas no responde, el endpoint devuelve 503 service_unavailable y el envío no se ve afectado. Las listas de emails, las exportaciones y los eventos de un email no son estadísticas; consulta Registros.
Pide los números
GET /emails/metrics necesita una clave de API de acceso total. Los SDK la llaman como emails.metrics().
curl "https://api.billionsend.com/emails/metrics?start_date=2026-11-01&end_date=2026-11-14&granularity=daily&metrics=sent&metrics=delivered&metrics=open_rate&dimensions=period" \
-H "Authorization: Bearer bs_..."
| Parámetro | Qué hace |
|---|---|
start_date, end_date |
El intervalo. Las estadísticas se leen en horas UTC completas, y la respuesta indica el inicio que usó. |
timezone |
Un nombre de zona IANA, como Europe/Berlin (no se acepta un desfase UTC como +05:00). Los periodos se cortan en esa zona. |
granularity |
hourly, daily, weekly o monthly: el tamaño de un periodo cuando dimensions incluye period. Un intervalo puede abarcar como máximo 10.000 periodos. |
metrics |
Repítelo por cada métrica que quieras (consulta más abajo). |
dimensions |
Repítelo por cada desglose: period, domain, email o broadcast. email y broadcast no se pueden combinar. |
domain_id, email_id, broadcast_id |
Filtros. Repite cada uno hasta 100 veces. |
La respuesta incluye totals para todo el intervalo y, cuando pides dimensiones, una fila por combinación en data.
Métricas
| Métrica | Cuenta |
|---|---|
received |
Destinatarios aceptados para el envío. No pertenece a ningún dominio, envío masivo ni email, así que una respuesta filtrada o desglosada por alguno de ellos la deja fuera. |
sent, delivered, delivery_delayed, failed, suppressed |
Destinatarios, según el resultado del envío. |
bounced, bounced_permanent, bounced_transient, bounced_undetermined |
Rebotes y las tres clases de rebote. |
complained, unsubscribed |
Quejas de spam y destinatarios que se dieron de baja con el enlace de baja. |
opened, clicked |
Cada apertura y cada clic. |
unique_opened, unique_clicked |
Emails abiertos o con clic al menos una vez. |
delivery_rate |
delivered ÷ sent |
bounce_rate |
bounced ÷ sent |
open_rate, click_rate |
unique_opened o unique_clicked ÷ delivered |
complaint_rate, unsubscribe_rate |
complained o unsubscribed ÷ delivered |
Las tasas son porcentajes con un decimal, y valen 0 cuando no hay nada que dividir. Las aperturas y los clics hechos por máquinas, como los proxies de privacidad y los escáneres de seguridad, no se cuentan como aperturas ni clics.
Con la dimensión email y sin email_id, la respuesta lista hasta 1000 emails creados en el intervalo.
Clics por enlace
GET /emails/metrics/links (una extensión de BillionSend, clave de acceso total) lista los enlaces en los que se hizo clic en un intervalo, del más al menos clicado:
curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
-H "Authorization: Bearer bs_..."
{
"object": "list",
"start_date": "2026-11-01T00:00:00.000Z",
"end_date": "2026-11-14T23:59:59.999Z",
"has_more": false,
"data": [
{ "link": "https://shop.example.com/sale", "clicked": 412, "bot_clicked": 37 }
]
}
- Un enlace se cuenta por su esquema, host y ruta. La query string y el fragmento se descartan, así que un enlace personalizado para cada destinatario es una sola fila y no se guarda ningún dato del destinatario.
clickedcuenta personas;bot_clickedcuenta las descargas hechas por máquinas, como escáneres de seguridad y vistas previas de enlaces.- Acepta
start_date,end_date,domain_id,broadcast_id(separados por comas) ylimit(de 1 a 100, 20 por defecto), y cubre horas UTC completas, igual queGET /emails/metrics. Los clics se cuentan por enlace desde el 16 de noviembre de 2026.
Aperturas y clics por país y cliente de correo
GET /emails/metrics/countries lista las aperturas y los clics de las personas según el país desde el que llegaron, y GET /emails/metrics/clients lista las aperturas según el cliente de correo que cargó las imágenes (ambas son extensiones de BillionSend, clave de acceso total), de mayor a menor interacción:
curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
-H "Authorization: Bearer bs_..."
{
"object": "list",
"start_date": "2026-11-16T00:00:00.000Z",
"end_date": "2026-11-30T23:59:59.999Z",
"has_more": false,
"data": [
{ "country": "BR", "opened": 1840, "unique_opened": 1203, "bot_opened": 95, "clicked": 311, "unique_clicked": 240, "bot_clicked": 22 },
{ "country": "unknown", "opened": 960, "unique_opened": 702, "bot_opened": 410, "clicked": 12, "unique_clicked": 9, "bot_clicked": 3 }
]
}
countryes el código ISO 3166-1 alfa-2 del país donde está registrada la dirección del lector. Valeunknowncuando la dirección no se puede ubicar, y en las aperturas a través de los proxies de imágenes de Gmail y Yahoo o de Apple Mail Privacy Protection: esas llegan desde la dirección del proveedor, no desde la del lector.clientes uno degmail,apple_mail,outlook,yahoo,thunderbird,other(un navegador web: el webmail y los clientes que no se identifican se ven igual) ounknown(sin user agent). Los clics no se cuentan por cliente, porque un clic llega desde el navegador al que el cliente de correo entrega el enlace.- Para las estadísticas solo se guardan el país y el cliente, nunca la dirección ni el user agent.
unique_openedyunique_clickedcuentan los emails cuya primera apertura o clic vino de ese país o cliente. Las personas y las máquinas se cuentan por separado, como enGET /emails/metrics.- Ambas aceptan
start_date,end_date,domain_idybroadcast_id(separados por comas), cubren horas UTC completas y devuelven todas las filas (los países y los clientes son una lista acotada). Las aperturas y los clics se cuentan por país y cliente desde el 16 de noviembre de 2026. - Geolocalización de IP de DB-IP, con licencia CC BY 4.0.
Relacionado
Insights de entregabilidad puntúa cada email y tu cuenta. Para reaccionar a un resultado en el momento en que ocurre, en lugar de contarlo después, usa webhooks.