Synup
Créer une clé
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
        ]
      }
    ]
  }
}

Guides qui utilisent cette ressource