API de visibilidad de marca y monitorización GEO

Mide periódicamente las menciones y citas de tu marca en la búsqueda con IA y compáralas con la competencia.

01

Repetir las mismas preguntas y condiciones

Guarda alias de marca, dominios, competidores, motores, preguntas y país. Programa intervalos de 1 a 168 horas. Mantén las mismas preguntas y motores para comparar periodos con la misma base.

02

Distinguir menciones, citas y cuota competitiva

Las menciones se detectan por alias en el texto; las citas, por coincidencia con los dominios registrados. Compara tasas de mención y cuota competitiva dentro del conjunto de respuestas recopiladas y evaluadas.

03

Seguir tu marca en ChatGPT

El ejemplo ejecuta la misma pregunta a diario en ChatGPT y Gemini. Separa preguntas de descubrimiento de categoría y comparaciones directas. Registra las variantes del nombre en aliases y los sitios oficiales cuyas citas seguirás en domains.

Métricas y denominadores de la API

GET /v1/monitors/:id ofrece las estadísticas del detalle clásico; GET /v1/monitors/:id/analytics ofrece métricas para informes. Distingue sus estructuras y denominadores, y consulta las respuestas y fuentes junto con los agregados.

  • En el detalle clásico, engineRates compara menciones y citas por motor; topDomains y topPages muestran las fuentes citadas.
  • El shareOfVoice del detalle clásico contiene runs y brands[].mentions. La tasa de mención independiente de cada marca se calcula como mentions ÷ runs × 100.
  • En analytics, brands[].mentionRate es menciones de la marca ÷ respuestas evaluadas para ella × 100. brands[].shareOfVoice es menciones de la marca ÷ todas las menciones de marcas seguidas × 100. Las cuotas suman 100% con denominador positivo; los valores sin muestra o condiciones comparables se representan con null.

Crear un monitor

Envía el siguiente cuerpo a POST /v1/monitors. Sustituye la marca y el dominio de ejemplo por tus objetivos reales. También puedes crear, editar y pausar monitores desde el panel.

JSON
{
  "name": "Earbud brand tracking",
  "engines": [
    "CHATGPT",
    "GEMINI"
  ],
  "prompts": [
    "best wireless earbuds for commuting"
  ],
  "aliases": [
    "Acme Audio"
  ],
  "domains": [
    "example.com"
  ],
  "competitors": [
    {
      "name": "Sony",
      "aliases": [
        "Sony"
      ]
    }
  ],
  "country": "US",
  "intervalHours": 24
}
01

Coste de tareas y cargos adicionales

Con una muestra y una ubicación, 12 preguntas en ChatGPT y Google AI Overviews crean 24 tareas y cuestan 27 créditos de base si todas terminan. La lectura de competidores añade 80 créditos por monitor cada 30 días, repartidos según la frecuencia y cobrados cuando se han enviado todas las tareas de una ejecución. Treinta ejecuciones diarias cuestan unos 890 créditos: 810 de tareas y 80 de lectura. analysis: true añade 1 crédito por respuesta analizada. El trabajo respeta la concurrencia y el saldo; vincula cada resultado completado mediante task.id.

02

Respuestas y fuentes del periodo en que cambió una tasa

Abre las respuestas y fuentes de ese periodo y revisa si cambiaron también las preguntas o la aparición de resúmenes de IA. Registra los dominios de la marca para seguir sus citas.

Funciones relacionadas

Empieza con 500 créditos gratis

Ejecuta tu primera tarea en el Playground o llama a la API con tu clave.