Pregunta a ChatGPT y Gemini desde una ubicación precisa

Usa payload.location en tareas CHATGPT y GEMINI para ver la respuesta de un usuario en ese lugar.

Qué obtienes

• Respuestas de barrio: las recomendaciones locales salen del entorno del punto que indicas, como una estación, una tienda o una esquina.
• location en cada resultado con lugar: las coordenadas desde las que se preguntó.
• El mismo control en el Playground: escribe un lugar o unas coordenadas en Ubicación (opcional), junto al botón de país.

Cómo funciona

Preguntas como “un buen dentista cerca” o “dónde comer hoy” dependen de dónde está el usuario. ChatGPT y Gemini las responden según la ubicación del usuario, así que el mismo prompt trae clínicas distintas en Gangnam y en Busan. Indica en payload.location un punto dentro del country de la tarea, y querying.ai pregunta al motor como un usuario que está allí.

Envía el punto como latitude y longitude en grados decimales, como en la solicitud de abajo. Las apps de mapas muestran esos números para cualquier punto que elijas, y el Playground los busca a partir del nombre de un lugar. Cada resultado devuelve el mismo punto en location.

La ubicación funciona en tareas CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP. La API comprueba el motor en el momento del envío y devuelve LOCATION_UNSUPPORTED para cualquier otro motor, así que cada tarea que se ejecuta responde para el lugar que elegiste.

Para qué sirve

• Comprueba si la IA recomienda tu clínica, restaurante o tienda a la gente de su propio barrio.
• Haz la misma pregunta desde varios barrios o ciudades para ver dónde lidera la competencia.
• Sigue cada sucursal de una cadena desde su propia dirección, con un conjunto de prompts por ubicació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/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "Best coffee shops near me for working on a laptop",
      "country": "US",
      "location": { "latitude": 40.72288, "longitude": -73.99875 }
    }
  }'

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

Un punto dentro de country, con latitude (-90 a 90) y longitude (-180 a 180) en grados decimales, por ejemplo {"latitude": 37.4979, "longitude": 127.0276}. El motor responde como a un usuario que está allí. Para CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP.

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": "e5aba119-a26e-4f82-a965-35c9234a428b",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:41:03.858Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "Here are several **nearby cafés that look particularly suitable for laptop work**, based on current local listings and work-friendly details:\n\n- The Lost Draft — **0.2 km away**. Laptop-friendly, with Wi-Fi, comfortable seating, and larger tables.\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://awifiplace.com/cities/new-york",
        "label": "Best Coffee Shops to Work in New York (2026) | 103 Cafes with WiFi",
        "attribution": "A Wifi.Place"
      }
    ],
    "searchQueries": [
      "best coffee shops for laptop work near me wifi outlets"
    ],
    "location": { "latitude": 40.72288, "longitude": -73.99875 }
  }
}

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

El punto que usó la respuesta, tal como lo enviaste: latitude y longitude.

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.

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"

Errores

LOCATION_UNSUPPORTEDHTTP 422

payload.location funciona en CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP. Los demás motores devuelven este código al enviar.

Precio

Una tarea con ubicación cuesta lo mismo que cualquier otra de su motor: 2 créditos en ChatGPT y 1 crédito en Gemini por tarea completada.