Synupv1
Crear clave
v1Recursos/Análisis de perfil

Análisis de perfil

Consulte las analíticas de rendimiento del perfil de una ubicación.

Devuelve métricas de vistas/acciones del perfil de una ubicación durante un rango de fechas, agregadas por cada fuente conectada (Google, Facebook, Apple, Bing).

Obtener analíticas del perfil

get/api/v1/analytics
analytics:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringobligatorio
El cliente de la ubicación.
fromstringopcional
Fecha de inicio (YYYY-MM-DD) del rango. Opcional — por defecto se usa la ventana estándar de la fuente.
tostringopcional
Fecha de fin (YYYY-MM-DD) del rango. Opcional.
Respuesta
dataobjectopcional
connectedSourcesarray of string (google | facebook | apple | bing)opcional
Qué plataformas tiene conectadas esta ubicación: google, facebook, apple, bing.
summarystringopcional
Un breve resumen legible del rendimiento, o null.
syncedAtstringopcional
Fecha de la última sincronización de estos datos, como marca de tiempo ISO 8601, o null.
latestDataDaystringopcional
Día más reciente con datos, como YYYY-MM-DD, o null.
profileViewsobjectopcional
Vistas de perfil a lo largo del tiempo.
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 (llamadas, solicitudes de indicaciones, visitas al sitio web, clics en botones) combinadas, a lo largo del tiempo.
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 a lo largo del tiempo.
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 a lo largo del tiempo.
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 indicaciones a lo largo del tiempo.
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 otros botones del perfil a lo largo del tiempo.
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
Seguidores de Facebook a lo largo del tiempo.
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 de Facebook a lo largo del tiempo.
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
Términos de búsqueda que mostraron este listado, solo Google.
keywordstringopcional
El término de búsqueda.
impressionsnumberopcional
Número de impresiones de ese término.
keywordMonthsobjectopcional
Rango de fechas que cubren los términos de búsqueda, o null.
fromstringopcional
tostringopcional
impressionSplitobjectopcional
Desglose de impresiones por superficie, solo Google, o null.
mapsnumberopcional
Impresiones en Google Maps.
searchnumberopcional
Impresiones en la Búsqueda de Google.
desktopnumberopcional
Impresiones en escritorio.
mobilenumberopcional
Impresiones en móvil.
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
Su clave de API
locationId *
clientId *
from
to
{
  "data": {
    "connectedSources": [
      "google"
    ],
    "summary": "Profile views are up 12% this month.",
    "syncedAt": "2026-02-01T00:00:00.000Z",
    "latestDataDay": "2026-01-31",
    "profileViews": {
      "metric": "Profile Views",
      "total": 1200,
      "previousTotal": 1050,
      "labels": [
        "2026-01-01",
        "2026-01-31"
      ],
      "bySource": {
        "google": [
          40,
          42
        ]
      }
    },
    "allActions": {
      "metric": "All Actions",
      "total": 300,
      "previousTotal": 280,
      "labels": [],
      "bySource": {}
    },
    "websiteVisits": {
      "metric": "Website Visits",
      "total": 150,
      "previousTotal": 140,
      "labels": [],
      "bySource": {}
    },
    "phoneCalls": {
      "metric": "Phone Calls",
      "total": 60,
      "previousTotal": 55,
      "labels": [],
      "bySource": {}
    },
    "directionRequests": {
      "metric": "Direction Requests",
      "total": 90,
      "previousTotal": 85,
      "labels": [],
      "bySource": {}
    },
    "buttonClicks": {
      "metric": "Button Clicks",
      "total": 20,
      "previousTotal": 18,
      "labels": [],
      "bySource": {}
    },
    "followers": {
      "metric": "Followers",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "postEngagement": {
      "metric": "Post Engagement",
      "total": null,
      "previousTotal": null,
      "labels": [],
      "bySource": {}
    },
    "searchKeywords": [
      {
        "keyword": "dentist near me",
        "impressions": 320
      }
    ],
    "keywordMonths": {
      "from": "2026-01-01",
      "to": "2026-01-31"
    },
    "impressionSplit": {
      "maps": 600,
      "search": 900,
      "desktop": 500,
      "mobile": 1000
    }
  }
}
v1Recursos/Análisis de perfil/getObtener 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.

Obtener un resumen de 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
    }
  }
}