Resumen de Analíticas
Consulta KPIs, series diarias, rankings, comparaciones, frescura y cobertura.
Consulta KPIs, series diarias, rankings, comparaciones, frescura y cobertura.
/api/v1/analytics/overviewDevuelve analíticas normalizadas para las cuentas y el periodo seleccionados.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
days | number | 30 | Ventana móvil en días |
startDate, endDate | fecha ISO | — | Rango explícito; ambos son obligatorios |
platform | string | — | Limita a una plataforma |
accountId, accountIds, groupId | string | — | Usa un único selector; accountIds se separa por comas |
comparison | previous | none | previous | Incluye el periodo anterior solo con cobertura completa |
metrics | string | — | Claves públicas separadas por comas |
includeSeries | boolean | true | Incluye los puntos de cada métrica |
curl 'https://dopost.co/api/v1/analytics/overview?days=30&comparison=previous' \
--header 'x-api-key: <apiKey>'curl 'https://dopost.co/api/v1/analytics/overview?days=30&comparison=previous' \
--header 'x-api-key: <apiKey>'{
"overview": {
"metrics": [
{ "key": "views", "value": 12400, "unit": "count", "aggregation": "DAY" }
],
"accounts": [
{
"rank": 1,
"accountId": "acc_123",
"platform": "INSTAGRAM",
"score": 82.4,
"metrics": []
}
],
"platforms": [
{
"rank": 1,
"platform": "INSTAGRAM",
"accountCount": 2,
"score": 82.4,
"metrics": []
}
]
},
"meta": { "dataThrough": "2026-08-22", "comparisonCoverage": "complete" }
}{
"overview": {
"metrics": [
{ "key": "views", "value": 12400, "unit": "count", "aggregation": "DAY" }
],
"accounts": [
{
"rank": 1,
"accountId": "acc_123",
"platform": "INSTAGRAM",
"score": 82.4,
"metrics": []
}
],
"platforms": [
{
"rank": 1,
"platform": "INSTAGRAM",
"accountCount": 2,
"score": 82.4,
"metrics": []
}
]
},
"meta": { "dataThrough": "2026-08-22", "comparisonCoverage": "complete" }
}Cada métrica incluye clave estable, etiqueta, valor, unidad, agregación, disponibilidad y periodo. Los valores no disponibles se omiten o se devuelven como null; los ceros medidos se devuelven como 0.
400 filtros/rango inválidos; 401 clave inválida; 403 falta el permiso o el plan; 429 límite de peticiones.
El filtro usa platform=GOOGLE_BUSINESS. impressions suma los cuatro desgloses Search/Maps; views representa esas mismas impresiones para las comparativas generales. No sumes ambos valores. Las métricas específicas son googleSearchDesktopImpressions, googleSearchMobileImpressions, googleMapsDesktopImpressions, googleMapsMobileImpressions, websiteClicks, callClicks, directionRequests, messagingClicks, bookings y menuClicks.
Con una plataforma o cuenta individual se incluyen las métricas disponibles; seleccionar varias cuentas o un grupo compuesto solo por Google Business también incluye el detalle. En selecciones mixtas se mantienen las métricas generales; metrics permite solicitar explícitamente las específicas. Estos datos pertenecen a la ubicación y no se atribuyen a publicaciones concretas. Search terms mensuales.