Saltar al contenido

Estadísticas

Cifras de envío por día y tasas de entrega, rebote, queja, apertura y clic.

Estadísticas de envío por día

GET/v1/stats

Scope necesario: read o full. Una clave full incluye send y read.

Estadísticas por día UTC de los emails del entorno de la clave (una clave test solo cuenta emails test). Cada email cuenta en el día en que se creó. Sin since/until: últimos 30 días hasta hoy; máximo 92 días. Los días sin actividad salen con ceros.

  • requested: emails creados; sent: entregados al proveedor; delivered, bounced, complained: según los eventos del proveedor; failed, suppressed, cancelled: según el estado final.
  • opened, clicked, unsubscribed: emails con al menos una apertura, clic o baja (campañas con seguimiento).
  • rates en %, con 2 decimales y null si no hay base: delivery y bounce sobre sent; complaint, open y click sobre delivered.

Parámetros

CampoDescripción
sincestring · query Primer día (UTC, YYYY-MM-DD). Por defecto, 30 días hasta until. Máximo 92 días en total.
untilstring · query Último día (UTC, inclusive). Por defecto, hoy.
campaignIdstring · query Solo los emails de esa campaña.
domainstring · query Solo los emails cuyo remitente es de ese dominio.

Respuestas

  • 200
    CampoDescripción
    sincestring · obligatorioej.: 2026-10-01
    untilstring · obligatorioej.: 2026-10-31
    environmentstring · obligatoriovalores: test | live
    days[]object[] · obligatorio
    days[].requestednumber · obligatorioEmails creados.
    days[].sentnumber · obligatorioEntregados al proveedor.
    days[].deliverednumber · obligatorioCon evidencia de entrega.
    days[].bouncednumber · obligatorio
    days[].complainednumber · obligatorio
    days[].failednumber · obligatorio
    days[].suppressednumber · obligatorio
    days[].cancellednumber · obligatorio
    days[].openednumber · obligatorioEmails con al menos una apertura.
    days[].clickednumber · obligatorioEmails con al menos un clic.
    days[].unsubscribednumber · obligatorioEmails que provocaron una baja.
    days[].datestring · obligatorioej.: 2026-10-31
    totalsobject · obligatorio
    totals.requestednumber · obligatorioEmails creados.
    totals.sentnumber · obligatorioEntregados al proveedor.
    totals.deliverednumber · obligatorioCon evidencia de entrega.
    totals.bouncednumber · obligatorio
    totals.complainednumber · obligatorio
    totals.failednumber · obligatorio
    totals.suppressednumber · obligatorio
    totals.cancellednumber · obligatorio
    totals.openednumber · obligatorioEmails con al menos una apertura.
    totals.clickednumber · obligatorioEmails con al menos un clic.
    totals.unsubscribednumber · obligatorioEmails que provocaron una baja.
    ratesobject · obligatorio
    rates.deliverynumber | null · obligatorio% entregados sobre enviados.
    rates.bouncenumber | null · obligatorio% rebotados sobre enviados.
    rates.complaintnumber | null · obligatorio% quejas sobre entregados.
    rates.opennumber | null · obligatorio% aperturas sobre entregados.
    rates.clicknumber | null · obligatorio% clics sobre entregados.
  • 429
    Límite de consultas superado.

Ejemplo

bash
curl "https://api.vemudo.com/v1/stats?since=2026-10-01&until=2026-10-31" -H "Authorization: Bearer $VEMUDO_API_KEY"