Sigue todo un mercado con los monitores de categoría

Clasifica las marcas que nombran los motores de IA en todo un mercado, con cuota de voz y tendencia diaria.

Qué obtienes

• Una clasificación de cada marca seguida que nombran las respuestas, con su puesto, tasa de mención, cuota de voz y cambio frente al intervalo anterior.
• Las tres marcas más nombradas en cada subárea y en cada motor, para ver dónde es fuerte cada marca.
• Tasas diarias de las cinco marcas líderes y una celda por prompt y motor que abre la respuesta que la respalda.

Cómo funciona

Un monitor de marca sigue una marca. Un monitor de categoría sigue un mercado: nombras la categoría, agrupas sus prompts por subárea y cada ejecución hace esos prompts a tus motores y registra qué marcas nombra cada respuesta. Fija mode en CATEGORY al crearlo; el tipo queda fijo durante toda la vida del monitor.

• category: el mercado tal como lo nombra un comprador, de 1 a 80 caracteres.
• promptTopics: asigna cada prompt a su subárea, con hasta 30 subáreas de 60 caracteres como máximo. Los prompts fuera del mapa cubren toda la categoría.
• competitors: hasta 25 marcas que indicas tú. Tras la primera ejecución, una lectura semanal de las respuestas añade hasta 25 marcas más que estas nombran.

GET /v1/monitors/{id}/analytics devuelve el informe. En category.brands, la cuota de voz es 100 × las menciones de una marca ÷ todas las menciones seguidas, así que las cuotas de un periodo suman 100. La tasa de una marca se divide entre su propio sampleSize, las respuestas evaluadas mientras estaba en la lista, así que una marca que añades hoy se mide desde hoy.

Para qué sirve

• Descubre qué marcas lideran tu mercado en las respuestas de IA y por cuánto.
• Mira en qué subáreas y motores domina cada competidor.
• Informa cada semana de la cuota de voz de la categoría a clientes o a la dirección.

Cómo empezar

En el panel, crea un monitor y elige Categoría como tipo de monitor. Escribe un tema y pulsa Ejecutar investigación: Prompt Research rellena los prompts, sus subáreas y las marcas a ordenar a partir de la demanda de búsqueda en KR o US, y revisas todo antes de crear el monitor.

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 market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

Campos de la solicitud

namestringObligatorio

Un nombre para el monitor.

modestringObligatorio

BRAND (por defecto) sigue tu marca. CATEGORY clasifica todas las marcas de un mercado.

categorystringObligatorio

El nombre del mercado, de 1 a 80 caracteres.

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.

promptTopicsobject

Asigna a cada prompt un subsector, como Kids. El informe clasifica las marcas por subsector.

competitorsarray

Las marcas que se clasifican desde el inicio, hasta 25. La lectura semanal añade hasta 25 más desde 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.

Respuesta

La respuesta, recortada para que se lea mejor.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "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 el informe

GET /v1/monitors/{id}/analytics devuelve el informe de los últimos 30 días. Las cifras de abajo vienen del informe público de zapatillas de running, recortadas para que se lea mejor.

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

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}

category.brandsarray

Las marcas de tu lista y todas las demás que nombran las respuestas, de más a menos menciones, con rank, mentionRate y shareOfVoice.

category.topicsarray

La misma clasificación para cada subsector, en el orden en que pregunta el monitor.

Exporta las respuestas

GET /v1/monitors/{id}/results devuelve una fila por respuesta, con las marcas que nombra en competitorHits. Añade format=csv para obtener un archivo que se abre en cualquier hoja de cálculo:

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

ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

Precio

Una ejecución cuesta lo mismo que la de un monitor de marca: una tarea por prompt y motor, al precio en créditos de cada motor. Encontrar las marcas del mercado suma 100 créditos al mes, repartidos entre las ejecuciones, y la investigación que rellena el formulario cuesta 12 créditos.