Synupv1
Crear clave
v1Recursos/SEO/getObtener la tabla de clasificación de competidores de una ubicación

Obtener la tabla de clasificación de competidores de una ubicación

Devuelve los negocios que dominan la cuadrícula de posicionamiento de esta ubicación para su palabra clave seguida más reciente, clasificados por cuánto de la cuadrícula ocupan en el top 3. Incluye su propio negocio (isYou) para comparación, y etiqueta las entradas que ya están en su registro de competidores seguidos con su ID de registro.

get/api/v1/seo/competitors
seo:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringopcional
El cliente de la ubicación.
Respuesta
dataobjectopcional
countnumberopcional
Número de competidores devueltos.
competitorsarray of objectopcional
La tabla de clasificación de competidores, incluido su propio negocio.
idstringopcional
Un identificador para este negocio (su ID de lugar, o una clave derivada cuando no hay un ID de lugar disponible).
competitorIdstringopcional
ID en su registro de competidores seguidos, presente solo cuando este negocio ya está registrado allí.
namestringopcional
Nombre del negocio.
isYoubooleanopcional
Si esta fila es su propio negocio.
ratingnumberopcional
Calificación en estrellas, o null.
reviewCountnumberopcional
Número de reseñas, o null.
avgRanknumberopcional
Posición promedio en los puntos de la cuadrícula donde apareció este negocio, o null.
top3Pctnumberopcional
Porcentaje de puntos de la cuadrícula donde este negocio posiciona en el top 3, promediado entre todas las palabras clave seguidas.
gridPointsnumberopcional
Número de puntos de la cuadrícula donde apareció este negocio.
categorystringopcional
Categoría del negocio, o null.
websitestringopcional
Sitio web del negocio, o null (la fuente de datos de búsqueda local no lo devuelve).
keywordBreakdownarray of objectopcional
La cobertura en el top 3 de este negocio, desglosada por cada palabra clave seguida.
keywordstringopcional
La palabra clave seguida.
top3Pctnumberopcional
Porcentaje de los puntos de la cuadrícula de esa palabra clave donde este negocio posiciona en el top 3.
featureComparisonarray of objectopcional
Filas de comparación característica por característica frente a su negocio, si las hay.
featurestringopcional
competitorbooleanopcional
youbooleanopcional
hoursComparisonarray of objectopcional
Filas de comparación de horario comercial frente a su negocio, si las hay.
daystringopcional
competitorstringopcional
youstringopcional
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/seo/competitors
Su clave de API
locationId *
clientId
{
  "data": {
    "count": 2,
    "competitors": [
      {
        "id": "cm_comp_1",
        "competitorId": "cm_competitor_1",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "rating": 4.6,
        "reviewCount": 210,
        "avgRank": 4.2,
        "top3Pct": 44,
        "gridPoints": 25,
        "category": "Dentist",
        "website": "https://acmedental.example.com",
        "keywordBreakdown": [
          {
            "keyword": "dentist near me",
            "top3Pct": 60
          }
        ],
        "featureComparison": [
          {
            "feature": "Online booking",
            "competitor": false,
            "you": true
          }
        ],
        "hoursComparison": [
          {
            "day": "Monday",
            "competitor": "9am–5pm",
            "you": "8am–6pm"
          }
        ]
      }
    ]
  }
}