Synupv1
Créer une clé
v1Ressources/Fiches publiées/getObtenir le Share of Voice

Obtenir le Share of Voice

Votre part de Grid Rank face aux concurrents nommés, vos mots-clés les plus performants classés par part top-3 actuelle, et une tendance mensuelle de rang moyen sur la fenêtre — pour un emplacement.

get/api/v1/seo/share-of-voice
seo:read
Paramètres de requête
locationIdstringobligatoire
L'emplacement à consulter. Retrouvez-le avec GET /api/v1/locations.
clientIdstringfacultatif
Le client de l'emplacement. Nécessaire uniquement pour lever une ambiguïté lorsque votre clé est limitée à des clients spécifiques.
fromstringfacultatif
Début de la fenêtre (date ISO). Par défaut, il y a 30 jours.
tostringfacultatif
Fin de la fenêtre (date ISO). Par défaut, maintenant.
Réponse
dataobjectfacultatif
comparisonobjectfacultatif
Vous face aux concurrents nommés selon la part top-3 du grid.
availablebooleanfacultatif
Indique si cet établissement dispose de données de grid-rank pour calculer le Share of Voice.
rowsarray of objectfacultatif
Une ligne par entreprise dans la comparaison — vous et vos concurrents nommés.
namestringfacultatif
Le nom de l'entreprise, ou le nom de votre propre client pour votre propre ligne.
top3Pctnumberfacultatif
Part des mots-clés suivis pour lesquels cette entreprise se classe dans le top 3 (0–100), ou null en cas de données insuffisantes.
isYoubooleanfacultatif
True sur la ligne correspondant à votre propre établissement. Omis (jamais false) sur les lignes des concurrents.
keywordsobjectfacultatif
Les mots-clés de cet emplacement, classés par part top-3 la plus récente.
availablebooleanfacultatif
Indique si cet établissement dispose de données de grid-rank pour calculer le Share of Voice.
rowsarray of objectfacultatif
Une ligne par mot-clé suivi.
keywordstringfacultatif
Le mot-clé suivi.
top3Pctnumberfacultatif
Part des mots-clés suivis pour lesquels cette entreprise se classe dans le top 3 (0–100), ou null en cas de données insuffisantes.
avgRanknumberfacultatif
Rang moyen sur la période, ou null en cas de données insuffisantes.
performanceobjectfacultatif
Tendance mensuelle de rang moyen par mot-clé, bornée par from/to.
availablebooleanfacultatif
Indique si cet établissement dispose de données de grid-rank pour calculer le Share of Voice.
seriesarray of objectfacultatif
Une série par mot-clé suivi.
keywordstringfacultatif
Le mot-clé suivi.
pointsarray of objectfacultatif
Points de données de rang moyen mensuel pour ce mot-clé.
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/share-of-voice
Votre clé API
locationId *
clientId
from
to
{
  "data": {
    "comparison": {
      "available": true,
      "rows": [
        {
          "name": "Acme Dental — Downtown",
          "top3Pct": 62,
          "isYou": true
        },
        {
          "name": "Bright Smiles Dental",
          "top3Pct": 74
        }
      ]
    },
    "keywords": {
      "available": true,
      "rows": [
        {
          "keyword": "dentist near me",
          "top3Pct": 62,
          "avgRank": 3.2
        }
      ]
    },
    "performance": {
      "available": true,
      "series": [
        {
          "keyword": "dentist near me",
          "points": [
            {
              "yearMonth": "2026-01",
              "avgRank": 3.6
            },
            {
              "yearMonth": "2026-02",
              "avgRank": 3.2
            }
          ]
        }
      ]
    }
  }
}