---
title: Analíticas
description: Estadísticas de entrega pocos segundos después de cada evento, en el panel y con GET /emails/metrics.
seo:
  title: API de analíticas de email
ai:
  exclude: true
---

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](/docs/es/concepts/logs).

## Pide los números

`GET /emails/metrics` necesita una [clave de API](/docs/es/api-reference/basics) de acceso total. Los SDK la llaman como `emails.metrics()`.

```sh
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:

```sh
curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
  -H "Authorization: Bearer bs_..."
```

```json
{
  "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.
- `clicked` cuenta personas; `bot_clicked` cuenta 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) y `limit` (de 1 a 100, 20 por defecto), y cubre horas UTC completas, igual que `GET /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:

```sh
curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
  -H "Authorization: Bearer bs_..."
```

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

- `country` es el código ISO 3166-1 alfa-2 del país donde está registrada la dirección del lector. Vale `unknown` cuando 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.
- `client` es uno de `gmail`, `apple_mail`, `outlook`, `yahoo`, `thunderbird`, `other` (un navegador web: el webmail y los clientes que no se identifican se ven igual) o `unknown` (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_opened` y `unique_clicked` cuentan 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 en `GET /emails/metrics`.
- Ambas aceptan `start_date`, `end_date`, `domain_id` y `broadcast_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](https://db-ip.com), con licencia CC BY 4.0.

## Relacionado

[Insights de entregabilidad](/docs/es/concepts/deliverability-insights) 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](/docs/es/concepts/webhooks).
