Presentamos Prompt Research

Prompt Research convierte un tema en las preguntas que la gente hace a los asistentes de IA y las ordena por la demanda de búsqueda mensual detrás de cada una.

Qué obtienes

• prompts: hasta 50 preguntas redactadas como se le pregunta a un asistente de IA, de mayor a menor demanda, cada una con su volumen de búsqueda mensual y su parte de la demanda del tema.
• El tema, la persona, la intención y la etapa del embudo de cada pregunta, para agruparlas por subárea y etapa de compra.
• monitorSet: las preguntas que un monitor GEO debe seguir, en el orden en que conviene añadirlas.
• brands: las marcas competidoras que atraen demanda de búsqueda en el mismo espacio.

Cómo funciona

Envía un tema semilla, como “protector solar”, y un mercado. Prompt Research mide la demanda de búsqueda mensual de ese tema en el mercado, con los últimos 30 días en KR y la media mensual de los últimos 12 meses en US, identifica las necesidades más buscadas y escribe cada una como la pregunta que una persona haría a un asistente de IA. KR devuelve preguntas en coreano y US en inglés, y la mayoría de las ejecuciones termina en 30 a 60 segundos.

Añade tu marca y una breve descripción de lo que vende, y cada pregunta recibe una puntuación fit. Las preguntas que contienen los nombres de tu marca quedan fuera, así un monitor creado con ellas mide las menciones que tu marca gana por sí misma.

La pestaña Investigación de prompts del Playground y el formulario de nuevo monitor ejecutan la misma investigación.

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/prompt-research \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "seed": "wireless earbuds", "country": "US", "limit": 20 }'

Campos de la solicitud

seedstringObligatorio

El tema: de 1 a 30 caracteres entre letras, dígitos y espacios simples, como sunscreen.

countrystringObligatorio

KR o US. Los prompts llegan en el idioma del mercado.

limitinteger

Prompts que se devuelven, de 1 a 50. Por defecto 20.

excludearray

Hasta 20 términos. Un prompt que contenga alguno sale del resultado.

monitorSizeinteger

Prompts en monitorSet, de 1 a 50. Por defecto 20.

monitorEnginesarray

Los motores que ejecutará tu monitor. Comprueba que monitorSize cabe en las 200 tareas de prompt × motor de un monitor.

brandstring

Tu marca. Los prompts que la nombran salen del resultado, así cada prompt mide demanda real.

brandDescriptionstring

Hasta 500 caracteres sobre qué vende tu marca y a quién. Añade fit a cada prompt y prioriza los prompts que tu marca responde.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

{
  "success": true,
  "task": {
    "id": "ba954bab-33ec-4bb0-b175-a9b85258a4ac",
    "taskType": "PROMPT_RESEARCH",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:55:29.285Z"
  },
  "credits": { "creditsToCharge": 12, "creditsCharged": 12 },
  "response": {
    "seed": "wireless earbuds",
    "country": "US",
    "language": "en",
    "seedMonthlySearchVolume": 165000,
    "promptsFound": 28,
    "prompts": [
      {
        "prompt": "Which noise-cancelling earbuds should I choose?",
        "topic": "Earbud features",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 118380,
        "demandShare": 0.2585
      },
      {
        "prompt": "What are the best wireless earbuds to buy?",
        "topic": "Choosing earbuds",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 78840,
        "demandShare": 0.1722
      }
    ],
    "monitorSet": {
      "prompts": [
        {
          "rank": 1,
          "prompt": "Which noise-cancelling earbuds should I choose?",
          "topic": "Earbud features",
          "persona": null,
          "intent": "commercial",
          "funnelStage": "consideration",
          "brandMentions": "likely",
          "monthlySearchVolume": 118380,
          "demandShare": 0.2585
        }
      ],
      "coverage": {
        "demandShare": 0.8406,
        "topics": { "total": 5, "covered": 5 },
        "personas": { "total": 9, "covered": 8 }
      }
    },
    "topics": [
      {
        "topic": "Choosing earbuds",
        "monthlySearchVolume": 191440,
        "promptCount": 9,
        "demandShare": 0.4181
      },
      {
        "topic": "Earbud features",
        "monthlySearchVolume": 161940,
        "promptCount": 6,
        "demandShare": 0.3537
      }
    ],
    "personas": [
      {
        "persona": "people who sleep with earbuds",
        "monthlySearchVolume": 17700,
        "promptCount": 1,
        "demandShare": 0.0387
      }
    ],
    "brands": [
      { "brand": "Beats", "monthlySearchVolume": 560980 },
      { "brand": "Apple", "monthlySearchVolume": 509920 },
      { "brand": "Samsung", "monthlySearchVolume": 91750 }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.

credits.creditsChargedinteger

Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.

response.promptsarray

Las preguntas que la gente hace a los asistentes de IA, de mayor a menor demanda, con topic, persona, intent, funnelStage, monthlySearchVolume y demandShare.

response.monitorSetobject

Los prompts que debe seguir un monitor, en el orden para añadirlos, con la coverage de demanda, temas y perfiles.

response.topicsarray

La demanda sumada por subtema, con monthlySearchVolume, demandShare y promptCount. personas hace lo mismo por público.

response.brandsarray

Las marcas que la gente busca en este espacio, con sus búsquedas mensuales.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Precio

Cada tarea de investigación completada usa 12 créditos.