Vigila tu marca en las respuestas de IA

Los monitores envían tu conjunto de prompts a los motores de IA que elijas con la frecuencia que fijes y puntúan cada respuesta según las menciones y citas de tu marca.

Qué obtienes

• Tasa de menciones: la proporción de respuestas que nombran tu marca, por motor y por prompt.
• Tasa de citas: la proporción de respuestas que citan uno de tus dominios.
• Una tabla de prompts por motores que muestra dónde aparece tu marca, con la respuesta completa detrás de cada celda.
• Una alerta por correo cuando la tasa de menciones cae por debajo del umbral que fijes.

Cómo funciona

Un monitor es un conjunto de prompts con nombre para un mercado: los prompts, los motores a los que preguntar, los nombres que identifican tu marca, tus dominios, un país y una frecuencia, de cada hora a cada semana. Cada ejecución envía todos los prompts a todos los motores y puntúa cada respuesta una vez: si nombra tu marca y dónde, si cita tus dominios y qué competidores aparecen a tu lado.

Cada cifra enlaza con las respuestas que la generan, así que cuando una tasa se mueve abres justo las respuestas que cambiaron y ves qué dijeron los motores.

Para qué sirve

• Sigue semana a semana tu presencia en las respuestas de IA para las preguntas de tus compradores.
• Encuentra los prompts y motores donde los competidores aparecen por delante de ti.
• Observa cómo se mueven las tasas de menciones y citas después de publicar contenido nuevo.

Cómo empezar

Crea un monitor desde Monitores en el panel o con POST /v1/monitors. Un prompt que contiene el nombre de tu marca cuenta siempre como mención, así que redacta los prompts con las palabras que usaría un comprador.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes, US",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "best running shoes for flat feet",
      "most comfortable running shoes for beginners"
    ],
    "aliases": ["Acme", "Acme Running"],
    "domains": ["acme.com"],
    "country": "US",
    "intervalHours": 24,
    "alertBelowPct": 30
  }'

Campos de la solicitud

namestringObligatorio

Un nombre para el monitor.

enginesarrayObligatorio

Motores a los que se pregunta, hasta 12, como CHATGPT, GEMINI, PERPLEXITY y GOOGLE.

promptsarrayObligatorio

De 1 a 100 preguntas que se hacen en cada ejecución, escritas como las haría un comprador.

aliasesarrayObligatorio

Los nombres y grafías de tu marca, hasta 20. Una respuesta que usa uno cuenta como mención.

domainsarray

Tus sitios, hasta 20. Una respuesta que cita uno cuenta como cita.

competitorsarray

Marcas con las que comparar, cada una con name y aliases. La lectura semanal añade las que nombran las respuestas.

countrystring

El mercado para el que responden los motores. Por defecto US.

intervalHoursinteger

Horas entre ejecuciones, de 1 a 168: 1 cada hora, 24 a diario, 168 cada semana.

alertBelowPctinteger

Alerta por correo cuando tu tasa de menciones baja de este porcentaje, de 1 a 100.

Respuesta

La respuesta, recortada para que se lea mejor.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes, US",
      "mode": "BRAND",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 24,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}

data.monitor.idstring

El ID del monitor. Úsalo para leer el informe, los resultados puntuados y cada respuesta.

data.monitor.nextRunAtstring

Cuándo empieza la próxima ejecución. La primera empieza al crear el monitor y después se ejecuta cada intervalHours.

Lee los resultados

Cada ejecución añade una fila por prompt y motor. GET /v1/monitors/{id}/results devuelve las filas de la más reciente a la más antigua, y nextCursor vuelve como cursor para la página siguiente. Estas filas vienen del informe público de zapatillas de running, recortadas para que se lea mejor.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)"
    },
    "truncated": true,
    "nextCursor": "2026-09-30T11:51:14.888000Z~7fc7c713-a2f2-41f8-befd-c04b830d69e5",
    "results": [
      {
        "taskId": "bc96f867-7349-4987-b498-f0080c149f3d",
        "engine": "PERPLEXITY",
        "prompt": "What are the best waterproof running shoes to choose?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:33.415000Z",
        "competitorHits": ["HOKA", "On", "Brooks", "Salomon"]
      },
      {
        "taskId": "6b8222fd-01bd-44d7-9a0b-8d0aecb32e19",
        "engine": "PERPLEXITY",
        "prompt": "What are the best running shoes for kids?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:14.888000Z",
        "competitorHits": ["HOKA", "On", "ASICS", "Nike", "New Balance"]
      }
    ]
  }
}

mentionedboolean

true cuando la respuesta nombra tu marca con uno de sus aliases.

citedboolean

true cuando la respuesta cita una página de uno de tus domains.

positioninteger

Posición en caracteres de la primera mención de tu marca, una medida de visibilidad. null cuando la respuesta deja fuera tu marca.

competitorHitsarray

Los competidores que nombra la respuesta.

taskIdstring

La respuesta detrás de la fila. GET /v1/monitors/{id}/answers/{taskId} la devuelve completa, con sus fuentes.

Precio

Una ejecución cuesta el número de prompts multiplicado por los créditos de cada motor. Por ejemplo, 12 prompts en ChatGPT (2 créditos) y Gemini (1 crédito) cuestan 36 créditos por ejecución, unos 1.080 al mes con frecuencia diaria.