Synupv1
Crear clave
v1Recursos/Listados publicados/getObtener Share of Voice

Obtener Share of Voice

Su cuota de Grid Rank frente a competidores designados, sus palabras clave con mejor rendimiento clasificadas por cuota top-3 actual, y una tendencia mensual de posición promedio en la ventana — para una ubicación.

get/api/v1/seo/share-of-voice
seo:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar. Búsquelo con GET /api/v1/locations.
clientIdstringopcional
El cliente de la ubicación. Solo necesario para desambiguar cuando su clave está limitada a clientes específicos.
fromstringopcional
Inicio de la ventana (fecha ISO). Por defecto, hace 30 días.
tostringopcional
Fin de la ventana (fecha ISO). Por defecto, ahora.
Respuesta
dataobjectopcional
comparisonobjectopcional
Usted frente a competidores designados por cuota top-3 de grid.
availablebooleanopcional
Si esta ubicación tiene datos de grid-rank para calcular el Share of Voice.
rowsarray of objectopcional
Una fila por cada negocio en la comparación — usted y sus competidores nombrados.
namestringopcional
El nombre del negocio, o el nombre de su propio cliente en su propia fila.
top3Pctnumberopcional
Porcentaje de palabras clave rastreadas en las que este negocio se posiciona entre los 3 primeros (0–100), o null si no hay datos suficientes.
isYoubooleanopcional
True en la fila de su propia ubicación. Se omite (nunca false) en las filas de la competencia.
keywordsobjectopcional
Las palabras clave de esta ubicación, clasificadas por cuota top-3 más reciente.
availablebooleanopcional
Si esta ubicación tiene datos de grid-rank para calcular el Share of Voice.
rowsarray of objectopcional
Una fila por cada palabra clave rastreada.
keywordstringopcional
La palabra clave rastreada.
top3Pctnumberopcional
Porcentaje de palabras clave rastreadas en las que este negocio se posiciona entre los 3 primeros (0–100), o null si no hay datos suficientes.
avgRanknumberopcional
Posición promedio durante la ventana, o null si no hay datos suficientes.
performanceobjectopcional
Tendencia mensual de posición promedio por palabra clave, acotada por from/to.
availablebooleanopcional
Si esta ubicación tiene datos de grid-rank para calcular el Share of Voice.
seriesarray of objectopcional
Una serie por cada palabra clave rastreada.
keywordstringopcional
La palabra clave rastreada.
pointsarray of objectopcional
Puntos de datos de posición promedio mensual para esta palabra clave.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/seo/share-of-voice
Su clave de 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
            }
          ]
        }
      ]
    }
  }
}