Synupv1
Crear clave
v1Recursos/Listados publicados/getObtener un resumen de listados

Obtener un resumen de listados

Estado de sincronización de publishers en las ubicaciones de este cliente (o de toda la agencia) — un resumen agregado más un desglose por ubicación, insights (% de salud, distribución de sincronización, publishers más débiles, elementos priorizados "requiere atención") y un titular determinista. Limita el alcance con tags. Usa el mismo rollup que la vista Listados → Todas las ubicaciones.

get/api/v1/listings/summary
listings:read
Parámetros de consulta
clientIdstringopcional
Limitar a las ubicaciones de un cliente.
tagsstringopcional
Nombres de tags de ubicación separados por comas — solo se incluyen las ubicaciones con al menos uno de estos.
pageintegeropcional
Página de filas por ubicación (base 1). Por defecto 1.
perPageintegeropcional
Filas por página (máx. 200). Por defecto 50.
Respuesta
dataobjectopcional
summaryobjectopcional
Recuentos agregados de todas las ubicaciones en el alcance.
locationsnumberopcional
Número de ubicaciones en el alcance.
publishersTotalnumberopcional
Total de espacios de publisher en todas las ubicaciones del alcance.
publishersSyncednumberopcional
De ellos, actualmente sincronizados.
connectionIssuesnumberopcional
Filas de conectores nativos (Google/Facebook) con un problema de conexión.
duplicatesnumberopcional
Listados duplicados detectados en el alcance.
reviewsnumberopcional
Total de reseñas en el alcance.
avgRatingnumberopcional
Calificación promedio entre las ubicaciones que tienen una.
rowsarray of objectopcional
Una fila por ubicación en el alcance (paginada).
locationIdstringopcional
ID de la ubicación.
namestringopcional
Nombre de la ubicación.
citystringopcional
Ciudad de la ubicación.
publishersnumberopcional
Espacios de publisher para esta ubicación.
syncednumberopcional
De ellos, actualmente sincronizados.
connectionIssuesnumberopcional
Filas de conectores nativos con un problema de conexión.
duplicatesnumberopcional
Listados duplicados detectados para esta ubicación.
reviewsnumberopcional
Total de reseñas de esta ubicación.
unrepliednumberopcional
Reseñas pendientes de respuesta.
avgRatingnumberopcional
Calificación promedio de esta ubicación.
googleVerifiedbooleanopcional
El listado de Google está conectado y verificado.
googleConnectedbooleanopcional
Google está conectado (puede seguir pendiente de verificación).
tagsarray of stringopcional
Tags internos de esta ubicación.
insightsobjectopcional
Insights derivados calculados a partir de las filas anteriores.
healthnumberopcional
publishersSynced / publishersTotal, como porcentaje.
distributionobjectopcional
Ubicaciones agrupadas por tasa de sincronización (fullySynced 100 %, healthy 90-99 %, atRisk <90 %).
fullySyncednumberopcional
Ubicaciones al 100 % de sincronización.
healthynumberopcional
Ubicaciones al 90-99 % de sincronización.
atRisknumberopcional
Ubicaciones por debajo del 90 % de sincronización.
weakestarray of objectopcional
Publishers con menor cobertura en el alcance.
idstringopcional
ID del publisher.
namestringopcional
Nombre del publisher.
totalnumberopcional
Ubicaciones que tienen este publisher.
syncednumberopcional
De ellas, sincronizadas.
requiresActionnumberopcional
De ellas, que requieren acción.
notConnectednumberopcional
De ellas, no conectadas.
pctnumberopcional
Porcentaje sincronizado, redondeado.
directoriesarray of objectopcional
Tabla completa de cobertura por publisher.
idstringopcional
ID del publisher.
namestringopcional
Nombre del publisher.
totalnumberopcional
Ubicaciones que tienen este publisher.
syncednumberopcional
De ellas, sincronizadas.
requiresActionnumberopcional
De ellas, que requieren acción.
notConnectednumberopcional
De ellas, no conectadas.
pctnumberopcional
Porcentaje sincronizado, redondeado.
attentionarray of objectopcional
Tarjetas priorizadas de "requiere atención".
nnumberopcional
Cantidad que representa esta tarjeta.
titlestringopcional
Título de la tarjeta.
substringopcional
Subtítulo de la tarjeta.
tonestring (amber | blue | rose | zinc)opcional
Tono visual de esta tarjeta.
filterstring (issues | duplicates | under80 | unverified | notconnected)opcional
Clave de filtro correspondiente en la tabla de ubicaciones.
headlinestringopcional
Un titular determinista de una línea sobre el estado del alcance.
fixFirstarray of objectopcional
Correcciones priorizadas.
textstringopcional
Descripción de la corrección.
impactstring (High | Med | Low)opcional
Impacto estimado de esta corrección.
filterstring (issues | duplicates | under80 | unverified | notconnected)opcional
Clave de filtro correspondiente en la tabla de ubicaciones.
totalnumberopcional
Total de ubicaciones coincidentes (para paginación), independiente de perPage.
pagenumberopcional
Página actual (base 1).
perPagenumberopcional
Filas por página.
Errores
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/listings/summary
Su clave de API
clientId
tags
page
perPage
{
  "data": {
    "summary": {
      "locations": 12,
      "publishersTotal": 96,
      "publishersSynced": 81,
      "connectionIssues": 3,
      "duplicates": 2,
      "reviews": 340,
      "avgRating": 4.6
    },
    "rows": [
      {
        "locationId": "loc_456",
        "name": "Acme Dental — Downtown",
        "city": "Austin",
        "publishers": 8,
        "synced": 7,
        "connectionIssues": 0,
        "duplicates": 0,
        "reviews": 26,
        "unreplied": 2,
        "avgRating": 4.8,
        "googleVerified": true,
        "googleConnected": true,
        "facebookConnected": true,
        "tags": [
          "vip"
        ]
      }
    ],
    "insights": {
      "health": 84,
      "distribution": {
        "fullySynced": 9,
        "healthy": 2,
        "atRisk": 1
      },
      "weakest": [
        {
          "locationId": "loc_789",
          "name": "Acme Dental — Eastside",
          "health": 40
        }
      ],
      "directories": [
        {
          "id": "google",
          "name": "Google Maps",
          "total": 12,
          "synced": 11,
          "requiresAction": 0,
          "notConnected": 1,
          "pct": 92
        }
      ],
      "attention": [
        {
          "n": 1,
          "title": "1 location under 90% synced",
          "sub": "Listings not fully propagated",
          "tone": "amber",
          "filter": "under80"
        }
      ],
      "headline": "84% listing health — 1 location under 90% synced needs attention.",
      "fixFirst": [
        {
          "text": "Reconnect 1 location's listing sync.",
          "impact": "Med"
        }
      ]
    },
    "total": 12,
    "page": 1,
    "perPage": 50
  }
}