Synupv1
Criar chave
v1Recursos/SEO/getObter o ranking de concorrentes de um local

Obter o ranking de concorrentes de um local

Retorna os negócios que dominam a grade de classificação deste local para sua palavra-chave monitorada mais recente, classificados por quanto da grade ocupam entre os 3 primeiros. Inclui seu próprio negócio (isYou) para comparação, e marca entradas já no seu registro de concorrentes monitorados com o ID do registro.

get/api/v1/seo/competitors
seo:read
Parâmetros de consulta
locationIdstringobrigatório
O local a ser consultado.
clientIdstringopcional
O cliente do local.
Resposta
dataobjectopcional
countnumberopcional
Número de concorrentes retornados.
competitorsarray of objectopcional
O ranking de concorrentes, incluindo seu próprio negócio.
idstringopcional
Um identificador para este negócio (seu place ID, ou uma chave derivada quando nenhum place ID está disponível).
competitorIdstringopcional
ID no seu registro de concorrentes monitorados, presente apenas quando este negócio já é monitorado ali.
namestringopcional
Nome do negócio.
isYoubooleanopcional
Se esta linha é o seu próprio negócio.
ratingnumberopcional
Classificação em estrelas, ou null.
reviewCountnumberopcional
Número de avaliações, ou null.
avgRanknumberopcional
Classificação média nos pontos da grade em que este negócio apareceu, ou null.
top3Pctnumberopcional
Percentual de pontos da grade em que este negócio classifica entre os 3 primeiros, calculado em todas as palavras-chave monitoradas.
gridPointsnumberopcional
Número de pontos da grade em que este negócio apareceu.
categorystringopcional
Categoria do negócio, ou null.
websitestringopcional
Site do negócio, ou null (não retornado pela fonte de dados de busca local).
keywordBreakdownarray of objectopcional
A cobertura entre os 3 primeiros deste negócio detalhada por palavra-chave monitorada.
keywordstringopcional
A palavra-chave monitorada.
top3Pctnumberopcional
Percentual dos pontos da grade dessa palavra-chave em que este negócio classifica entre os 3 primeiros.
featureComparisonarray of objectopcional
Linhas de comparação de recursos contra o seu negócio, se houver.
featurestringopcional
competitorbooleanopcional
youbooleanopcional
hoursComparisonarray of objectopcional
Linhas de comparação de horário de funcionamento contra o seu negócio, se houver.
daystringopcional
competitorstringopcional
youstringopcional
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/seo/competitors
Sua chave 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"
          }
        ]
      }
    ]
  }
}