v1Ressources/SEO/getObtenir les tendances de classement des concurrents dans le temps

Obtenir les tendances de classement des concurrents dans le temps

Renvoie le classement moyen mensuel de chaque concurrent sur l'historique de classement suivi de cet établissement (jusqu'aux 12 derniers mois mesurés), pour le graphique de tendance de classement. Inclut votre propre entreprise (isYou).

get/api/v1/seo/competitors/trends

seo:read

Paramètres de requête

locationIdstringobligatoire

L'établissement à consulter.

clientIdstringfacultatif

Le client de l'établissement.

Réponse

dataobjectfacultatif

monthsarray of stringfacultatif

Mois couverts, du plus ancien au plus récent (YYYY-MM).

competitorsarray of objectfacultatif

Une série par concurrent (plus votre propre entreprise), alignée sur months.

placeIdstringfacultatif

Un identifiant pour cette entreprise (son place ID, ou une clé dérivée).

namestringfacultatif

Nom de l'entreprise.

isYoubooleanfacultatif

Si cette série est votre propre entreprise.

monthlyarray of numberfacultatif

Classement moyen pour chaque mois dans months ; null quand cette entreprise n'a pas été observée ce mois-là.

Erreurs

400Il manque un paramètre requis à la requête, ou elle est invalide.

401Clé API manquante, invalide, expirée ou révoquée.

403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.

429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.

get/api/v1/seo/competitors/trends

Votre clé API

locationId *

clientId

{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "competitors": [
      {
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "monthly": [
          5.1,
          4.2
        ]
      }
    ]
  }
}