Ir para o conteúdo

Campanha — Estatísticas

Obter estatísticas da campanha.

Endpoint

Método URL
GET /campaign/<campaign>/stats/<event>

Onde <event> é um de: delivered, bounced, opened, clicked, unsubscribed, link_clicked

Nota

sent não é um evento válido e devolve HTTP 404. Para contabilizar todas as mensagens que saíram da fila, usar delivered mais bounced.

Os eventos são devolvidos por ordem ascendente de timestamp. A coleção é paginada com os parâmetros page e pagesize (intervalo de pagesize [10, 100], por omissão 10); não existe filtro de datas do lado do servidor nos eventos de campanha.


GET /campaign/<campaign>/stats/<event>

Payload: Sem payload.

Devolve: Um dicionário de estatísticas.

Example:

curl -u "username:api_key" -H "Accept: application/json" \
  https://app.duo.pt/campaign/{campaign_id}/stats/opened

Response:

{
  "success": true,
  "data": {
    "campaign": {
      "id": 1,
      "owner": 1,
      "list": 1,
      "name": "Summer Newsletter 2026",
      "domain": 1,
      "segments": [],
      "recipients": null,
      "state": "DRAFT",
      "when": {
        "date": "2026-06-22 21:54:05.000000",
        "timezone_type": 3,
        "timezone": "UTC"
      },
      "event_callback": null
    },
    "events": [],
    "page": 1,
    "pageSize": 10,
    "pageCount": 0
  }
}