Synupv1
Crear clave
v1Recursos/Análisis de perfil/getObtener un resumen de análisis de perfil

Obtener un resumen de análisis de perfil

Análisis de perfil agregado en las ubicaciones de un cliente — visualizaciones de perfil, todas las acciones, visitas al sitio web, llamadas telefónicas, solicitudes de direcciones, clics en botones, seguidores e interacción con publicaciones, además de una tabla de clasificación por ubicación. Limita a un solo tag con tagId, u omítelo para todas las ubicaciones del cliente. Usa el mismo rollup que la vista Listados → Todas las ubicaciones → Análisis de perfil.

get/api/v1/analytics/summary
analytics:read
Parámetros de consulta
clientIdstringobligatorio
El cliente a agregar. Obligatorio.
tagIdstringopcional
Un ID de tag de ubicación (de GET /api/v1/locations/tags con withId=1) — limita el rollup a las ubicaciones de ese tag. Omítelo para todas las ubicaciones del cliente.
fromstringopcional
Inicio de la ventana (fecha ISO). Por defecto, hace 30 días.
tostringopcional
Fin de la ventana (fecha ISO). Por defecto, ahora.
sourcesstringopcional
Publishers a incluir, separados por comas: google, facebook, apple, bing. Por defecto, todos.
comparisonstring (none | previous_period)opcional
Comparar los totales con una ventana anterior de la misma duración.
granularitystring (daily | weekly | monthly)opcional
Intervalo de tiempo para la serie subyacente.
leaderboardLimitintegeropcional
Top-N ubicaciones en la tabla de clasificación (1-100). Por defecto 25.
leaderboardSearchstringopcional
Filtrar la tabla de clasificación por nombre de ubicación.
Respuesta
dataobjectopcional
connectedSourcesarray of string (google | facebook | apple | bing)opcional
Publishers conectados en al menos una ubicación del alcance.
locationsnumberopcional
Número de ubicaciones en el alcance.
coverageobjectopcional
Cuántas de las ubicaciones en el alcance reportaron datos en la ventana.
withDatanumberopcional
Ubicaciones que reportaron datos.
totalnumberopcional
Ubicaciones en el alcance.
summarystringopcional
Resumen de IA a nivel de cliente — no se completa en este rollup (siempre null).
syncedAtstringopcional
Cuándo se ejecutó por última vez la agregación subyacente.
latestDataDaystringopcional
El día más reciente con datos, en todo el alcance.
profileViewsobjectopcional
Visualizaciones de perfil, sumadas en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
allActionsobjectopcional
Todas las acciones de clientes, sumadas en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
websiteVisitsobjectopcional
Visitas al sitio web, sumadas en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
phoneCallsobjectopcional
Llamadas telefónicas, sumadas en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
directionRequestsobjectopcional
Solicitudes de direcciones, sumadas en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
buttonClicksobjectopcional
Clics en botones, sumados en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
followersobjectopcional
Serie de KPI de seguidores, sumada en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
postEngagementobjectopcional
Interacción con publicaciones, sumada en el alcance.
metricstringopcional
Nombre de la métrica.
totalnumberopcional
Total del rango seleccionado, o null.
previousTotalnumberopcional
Total del rango comparable anterior, o null.
labelsarray of stringopcional
Etiquetas de fecha para cada punto de la serie.
bySourceobjectopcional
Valores diarios desglosados por fuente conectada.
searchKeywordsarray of objectopcional
Siempre vacío en este rollup — los datos de palabras clave por ubicación están en GET /api/v1/analytics.
keywordstringopcional
impressionsnumberopcional
keywordMonthsobjectopcional
Siempre null en este rollup.
fromstringopcional
tostringopcional
followersTotalobjectopcional
Medidor de seguidores de Facebook, al final de la ventana.
totalnumberopcional
Número actual de seguidores.
previousTotalnumberopcional
Número de seguidores al final de la ventana anterior (cuando se solicita comparación).
locationsnumberopcional
Ubicaciones que contribuyen al medidor.
leaderboardobjectopcional
Clasificación por ubicación según visualizaciones de perfil.
rowsarray of objectopcional
Una fila por ubicación, clasificada por visualizaciones de perfil.
locationIdstringopcional
ID de la ubicación.
namestringopcional
Nombre de la ubicación.
citystringopcional
Ciudad de la ubicación.
profileViewsnumberopcional
Visualizaciones de perfil de esta ubicación.
allActionsnumberopcional
Todas las acciones de esta ubicación.
phoneCallsnumberopcional
Llamadas telefónicas de esta ubicación.
directionRequestsnumberopcional
Solicitudes de direcciones de esta ubicación.
deltaPctnumberopcional
Cambio respecto a la ventana anterior, en visualizaciones de perfil.
sparkarray of numberopcional
Visualizaciones de perfil por periodo a lo largo de la ventana, para un sparkline.
totalnumberopcional
Total de ubicaciones coincidentes (para paginación).
pagenumberopcional
Página actual de la clasificación (base 0).
pageSizenumberopcional
Tamaño de página de la clasificación.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/analytics/summary
Su clave de API
clientId *
tagId
from
to
sources
comparison
granularity
leaderboardLimit
leaderboardSearch
{
  "data": {
    "connectedSources": [
      "google",
      "facebook"
    ],
    "summary": null,
    "syncedAt": "2026-02-01T00:00:00.000Z",
    "latestDataDay": "2026-01-31",
    "profileViews": {
      "metric": "Profile Views",
      "total": 4800,
      "previousTotal": 4300,
      "labels": [
        "2026-01-01",
        "2026-01-31"
      ],
      "bySource": {
        "google": [
          160,
          168
        ]
      }
    },
    "allActions": {
      "metric": "All Actions",
      "total": 1100,
      "previousTotal": 980,
      "labels": [],
      "bySource": {}
    },
    "websiteVisits": {
      "metric": "Website Visits",
      "total": 600,
      "previousTotal": 540,
      "labels": [],
      "bySource": {}
    },
    "phoneCalls": {
      "metric": "Phone Calls",
      "total": 210,
      "previousTotal": 195,
      "labels": [],
      "bySource": {}
    },
    "directionRequests": {
      "metric": "Direction Requests",
      "total": 340,
      "previousTotal": 300,
      "labels": [],
      "bySource": {}
    },
    "buttonClicks": {
      "metric": "Button Clicks",
      "total": 80,
      "previousTotal": 70,
      "labels": [],
      "bySource": {}
    },
    "followers": {
      "metric": "Followers",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "postEngagement": {
      "metric": "Post Engagement",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "searchKeywords": [],
    "keywordMonths": null,
    "impressionSplit": {
      "maps": 0,
      "search": 0,
      "desktop": 0,
      "mobile": 0
    },
    "followersTotal": {
      "total": 812,
      "previousTotal": 790,
      "locations": 4
    },
    "coverage": {
      "withData": 4,
      "total": 5
    },
    "locations": 5,
    "leaderboard": {
      "rows": [
        {
          "locationId": "cl_a1b2c3",
          "synupLocationId": "os_9f8e7d6c",
          "name": "Acme Dental — Downtown",
          "city": "Austin",
          "profileViews": 1900,
          "allActions": 420,
          "phoneCalls": 90,
          "directionRequests": 140,
          "deltaPct": 0.12,
          "spark": [
            58,
            61,
            64,
            60,
            66
          ]
        }
      ],
      "total": 5,
      "page": 0,
      "pageSize": 25
    }
  }
}