Synup
Criar chave
v1Recursos/SEO/getObter tendências de classificação de concorrentes ao longo do tempo

Obter tendências de classificação de concorrentes ao longo do tempo

Retorna a classificação média mensal de cada concorrente no histórico de classificação monitorado deste local (até os últimos 12 meses medidos), para o gráfico de tendência de classificação. Inclui seu próprio negócio (isYou).

get/api/v1/seo/competitors/trends
seo:read
Parâmetros de consulta
locationIdstringobrigatório
O local a ser consultado.
clientIdstringopcional
O cliente do local.
Resposta
dataobjectopcional
monthsarray of stringopcional
Meses cobertos, do mais antigo ao mais recente (YYYY-MM).
competitorsarray of objectopcional
Uma série por concorrente (além do seu próprio negócio), alinhada aos meses.
placeIdstringopcional
Um identificador para este negócio (seu place ID, ou uma chave derivada).
namestringopcional
Nome do negócio.
isYoubooleanopcional
Se esta série é o seu próprio negócio.
monthlyarray of numberopcional
Classificação média para cada mês em months; null onde este negócio não foi observado naquele mês.
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/trends
Sua chave de API
locationId *
clientId
{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "competitors": [
      {
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "monthly": [
          5.1,
          4.2
        ]
      }
    ]
  }
}

Guias que usam este recurso