Skip to main content
GET
/
marketing
/
v3
/
emails
/
statistics
/
histogram
Obtener intervalos de estadísticas agrupadas
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/emails/statistics/histogram \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "aggregateStatistic": {
        "counters": {
          "bounce": 0,
          "click": 8,
          "contactslost": 0,
          "delivered": 704,
          "dropped": 1,
          "hardbounced": 0,
          "notsent": 1,
          "open": 443,
          "pending": 0,
          "selected": 705,
          "sent": 704,
          "softbounced": 0,
          "spamreport": 0,
          "suppressed": 0,
          "unsubscribed": 0
        },
        "deviceBreakdown": {
          "click_device_type": {
            "computer": 6,
            "mobile": 2,
            "unknown": 0
          },
          "open_device_type": {
            "computer": 44,
            "mobile": 8,
            "unknown": 391
          }
        },
        "qualifierStats": {},
        "ratios": {
          "bounceratio": 0,
          "clickratio": 1.136,
          "clickthroughratio": 1.806,
          "contactslostratio": 0,
          "deliveredratio": 100,
          "hardbounceratio": 0,
          "notsentratio": 0.142,
          "openratio": 62.926,
          "pendingratio": 0,
          "softbounceratio": 0,
          "spamreportratio": 0,
          "unsubscribedratio": 0
        }
      },
      "interval": {
        "end": "2020-06-01T04:00:00Z",
        "start": "2020-05-01T04:00:00Z"
      }
    },
    {
      "aggregations": {
        "counters": {
          "bounce": 1,
          "click": 0,
          "contactslost": 1,
          "delivered": 4,
          "dropped": 1,
          "hardbounced": 1,
          "notsent": 1,
          "open": 4,
          "pending": 0,
          "selected": 6,
          "sent": 5,
          "softbounced": 0,
          "spamreport": 0,
          "suppressed": 0,
          "unsubscribed": 0
        },
        "deviceBreakdown": {
          "click_device_type": {
            "computer": 0,
            "mobile": 0,
            "unknown": 0
          },
          "open_device_type": {
            "computer": 0,
            "mobile": 0,
            "unknown": 4
          }
        },
        "qualifierStats": {},
        "ratios": {
          "bounceratio": 20,
          "clickratio": 0,
          "clickthroughratio": 0,
          "contactslostratio": 20,
          "deliveredratio": 80,
          "hardbounceratio": 20,
          "notsentratio": 16.667,
          "openratio": 100,
          "pendingratio": 0,
          "softbounceratio": 0,
          "spamreportratio": 0,
          "unsubscribedratio": 0
        }
      },
      "interval": {
        "end": "2020-07-01T04:00:00Z",
        "start": "2020-06-01T04:00:00Z"
      }
    },
    {
      "aggregations": {
        "counters": {},
        "deviceBreakdown": {},
        "qualifierStats": {},
        "ratios": {}
      },
      "interval": {
        "end": "2020-07-02T00:00:00Z",
        "start": "2020-07-01T04:00:00Z"
      }
    }
  ],
  "total": 3
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito
Esta API requiere uno de los siguientes ámbitos:
content

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

interval
enum<string>

El intervalo para el que se agruparán las estadísticas.

Available options:
YEAR,
QUARTER,
MONTH,
WEEK,
DAY,
HOUR,
QUARTER_HOUR,
MINUTE,
SECOND
startTimestamp
string

La marca de tiempo inicial del período de tiempo, en formato ISO8601.

endTimestamp
string

La marca de tiempo final del período de tiempo, en formato ISO8601.

emailIds
integer[]

Filtra por los ID de correo. Incluye solo las estadísticas de los correos con estos ID.

Response

successful operation

Response object for collections of EmailStatisticIntervals.

total
integer
required

Número total de objetos.

results
object[]
required

Colección de objetos.

I