ChatGPT ya está disponible

Pregunta a ChatGPT desde el mercado que elijas y recibe en JSON la respuesta que ve un visitante real de ese mercado, con todas las fuentes citadas.

Qué obtienes

• text y markdown: la respuesta completa, en texto plano y con su formato.
• sources: cada página que cita la respuesta, en orden, con su URL y su título.
• searchQueries: las búsquedas web que hizo ChatGPT al responder, para ver cómo investigó tu prompt.
• model: el modelo que respondió en esa sesión.

Cómo funciona

Cada tarea abre una sesión nueva de ChatGPT en el país que indiques y hace tu pregunta tal como la escribiste. Recibes la respuesta que obtiene un visitante nuevo de ese mercado, así que las marcas que recomienda y las páginas que cita son las que leen tus clientes.

Cada ejecución es una observación nueva. Repite los mismos prompts de forma periódica y compara las ejecuciones para ver cómo cambian con el tiempo la respuesta, las marcas recomendadas y las páginas citadas.

Para qué sirve

• Comprueba si ChatGPT recomienda tu marca en las preguntas que hacen tus compradores.
• Encuentra las páginas que ChatGPT cita en tu categoría y planifica tu contenido en torno a ellas.
• Compara la respuesta a un mismo prompt entre países.

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/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.promptstringObligatorio

La pregunta, escrita como la teclea un usuario en el chat. Hasta 100.000 caracteres.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.locationstring

Un lugar dentro de country, como una estación, un barrio o una dirección, de hasta 200 caracteres. El motor responde como a un usuario que está allí. Para CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP.

payload.include.markdownboolean

Devuelve markdown, la respuesta con sus títulos, listas, tablas y enlaces. Activado por defecto.

payload.include.searchQueriesboolean

Devuelve searchQueries, las búsquedas web que hizo ChatGPT para la respuesta. Activado por defecto.

payload.include.shoppingboolean

Devuelve como shoppingCards las fichas de producto que muestra ChatGPT. Activado por defecto.

payload.include.rawResponseboolean

Con true llega también la salida original del motor junto al resultado estructurado, para tu propio análisis. Desactivado por defecto.

webhook.urlstring

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

idempotencyKeystring

Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

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

{
  "success": true,
  "task": {
    "id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}

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.textstring

La respuesta en texto plano.

response.markdownstring

La respuesta con su formato: títulos, listas, tablas y enlaces.

response.sourcesarray

Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

response.searchQueriesarray

Las búsquedas web que hizo el motor para escribir la respuesta.

response.shoppingCardsarray

Fichas de producto que acompañan la respuesta: nombre, precio, tienda, valoración y enlace.

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 ChatGPT completada usa 2 créditos.