Synup
Crear clave
v1Recursos/SEO/getObtener el resumen de posicionamiento de todas las ubicaciones

Obtener el resumen de posicionamiento de todas las ubicaciones

Devuelve una fila de resumen por cada ubicación que tenga al menos un informe de posicionamiento, opcionalmente limitada a un cliente y/o etiquetas de ubicación. Una clave restringida a clientes específicos debe indicar clientId.

get/api/v1/seo/rollup
seo:read
Parámetros de consulta
clientIdstringopcional
Restringe los resultados a un cliente. Cuando su clave está limitada a clientes específicos, esto es obligatorio.
tagsstringopcional
Nombres de etiquetas de ubicación separados por comas. Solo se incluyen las ubicaciones que tengan al menos una de estas etiquetas.
Respuesta
dataobjectopcional
countnumberopcional
Número de filas devueltas.
rowsarray of objectopcional
Una fila por ubicación con al menos un informe de posicionamiento.
idstringopcional
Identificador único de la ubicación.
locationNamestringopcional
El nombre comercial de la ubicación.
citystringopcional
Ciudad, o null.
avgRanknumberopcional
Posición promedio media entre las palabras clave activas de la ubicación, o null.
top3Pctnumberopcional
Porcentaje medio de puntos de la cuadrícula en el top 3 entre las palabras clave de la ubicación, o null.
top10Pctnumberopcional
Porcentaje medio de puntos de la cuadrícula en el top 10 entre las palabras clave de la ubicación, o null.
bestKeywordobjectopcional
La palabra clave mejor posicionada de la ubicación, o null.
keywordstringopcional
avgRanknumberopcional
tagsarray of stringopcional
Las etiquetas internas de la ubicación.
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/seo/rollup
Su clave de API
clientId
tags
{
  "data": {
    "count": 2,
    "rows": [
      {
        "id": "cm_loc_1",
        "locationName": "Acme Dental — Downtown",
        "city": "Austin",
        "avgRank": 4.2,
        "top3Pct": 44,
        "top10Pct": 78,
        "bestKeyword": {
          "keyword": "dentist near me",
          "avgRank": 4.2
        },
        "tags": [
          "priority",
          "downtown"
        ]
      }
    ]
  }
}

Guías que usan este endpoint