API - Resumen de estadísticas de Email Marketing

Esta guía explica cómo consultar los resultados de tus envíos de Email Marketing desde otro sistema o una herramienta de integración.

Podés consultar un envío en particular o los envíos de un período para conocer sus entregas, aperturas, clics, rebotes y bajas.

¿Qué hace esta API?

Devuelve un resumen de los resultados de cada envío que coincida con tu consulta. Por ejemplo, podés usarla para llevar las estadísticas a un reporte externo.

La consulta solo incluye envíos con estado finalizado. No aparecen los envíos en borrador, programados o en ejecución, aunque indiques su ID.

Consultar las estadísticas no realiza nuevos envíos ni modifica los existentes.

Qué necesitás antes de empezar

El ID del envío suele verse en la dirección del reporte. Por ejemplo, si la dirección termina en /outbound/emails/report/?id=12345, el ID es 12345.

Compartí la API Key únicamente con quien configure la integración y guardala en un lugar seguro.

Cómo se realiza la consulta

Si otra persona configura la integración por vos, podés compartirle esta sección.

Datos disponibles

Si no indicás un ID ni fechas, se consultan los últimos 30 días. Para elegir fechas concretas, usá date_from y date_to sin agregar date_range.

Consultar un envío en particular

Indicá el ID del Email Marketing en el parámetro id.

Ejemplo con datos de muestra:

https://api.datacrush.la/emailmarketing/resume?portal_id=TU_PORTAL_ID&api_key=TU_API_KEY&id=12345

Reemplazá TU_PORTAL_ID, TU_API_KEY y 12345 por tus datos.

Con esta opción podés consultar un envío anterior a los últimos 30 días sin indicar fechas. 

Consultar los envíos de un período

Indicá las fechas de inicio y fin. Por ejemplo, para consultar del 1 al 20 de octubre de 2026:

https://api.datacrush.la/emailmarketing/resume?portal_id=TU_PORTAL_ID&api_key=TU_API_KEY&date_from=2026-01-01&date_to=2026-02-01

Para consultar los últimos 30 días, podés omitir las fechas:

https://api.datacrush.la/emailmarketing/resume?portal_id=TU_PORTAL_ID&api_key=TU_API_KEY

Para limitar cualquiera de estas consultas a una campaña, agregá &campaign_id=ID_DE_LA_CAMPAÑA.

Las estadísticas corresponden al resultado acumulado de cada envío. El período selecciona qué envíos consultar; no limita las aperturas o los clics a los ocurridos dentro de esas fechas.

Qué información vas a recibir

Cada envío incluye estos datos:

Los porcentajes se muestran redondeados, sin decimales, por ejemplo 30%. Si no hay entregas para calcular uor, se devuelve vacío. Si no hay aperturas únicas o clics únicos, ctor se devuelve vacío, incluso cuando esperarías ver 0%.

Si hay aperturas únicas pero la cantidad de entregados es cero o menor, la respuesta usa la cantidad de aperturas únicas como cantidad de entregados.

Ejemplo de respuesta correcta

Este ejemplo es ilustrativo:

{
  "result": "success",
  "rows": [
    {
      "id": "45678",
      "name": "Novedades de octubre",
      "date": "2026-10-15 10:00:00",
      "subject": "Conocé nuestras novedades",
      "from_name": "Mi empresa",
      "from_email": "novedades@ejemplo.com",
      "delivered": 1000,
      "open_unique": 300,
      "uor": "30%",
      "click_unique": 60,
      "ctor": "20%",
      "complains": 0,
      "unsubscribed": 5,
      "bounced": 20,
      "content": "<html><body>Contenido del email</body></html>"
    }
  ]
}

success indica que la consulta se realizó correctamente. Dentro de rows aparece la lista de envíos encontrados. Aunque consultes un solo ID, el resultado mantiene ese formato de lista.

Consulta sin resultados

{
  "result": "success",
  "rows": []
}

Esto significa que no se encontraron envíos que cumplan los filtros. No necesariamente es un error: el envío puede no estar finalizado, el ID puede ser incorrecto o las fechas pueden no incluirlo.

Si la consulta no funciona

Pasos recomendados

1. Conseguí el Portal ID y la API Key del portal que querés consultar.
2. Elegí si necesitás los resultados de un envío o los de un período.
3. Para un envío específico, copiá su ID desde el reporte y usalo en id.
4. Configurá la consulta en tu sistema o herramienta de integración.
5. Usá los datos recibidos para completar tu reporte externo.

Preguntas frecuentes

¿Puedo consultar un envío específico?

Sí. Agregá id con el número del Email Marketing. No necesitás indicar fechas.

¿Puedo consultar un envío de hace más de 30 días?

Sí. Indicá su id o elegí un período que incluya la fecha del envío.

¿Puedo consultar un envío que todavía está en ejecución?

Esta consulta solo devuelve envíos con estado executed. Un envío en ejecución no aparece, aunque tenga estadísticas en la plataforma.

¿Voy a recibir los resultados de cada contacto?

No. Esta API devuelve un resumen por envío, sin el detalle individual de aperturas o clics de cada destinatario.

¿Esta API envía correos?

No. Solo permite consultar resultados.