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
        ]
      }
    ]
  }
}