Pregunta a ChatGPT y Gemini desde una ubicación precisa
Answers
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.
JSON
{
"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 statusQUEUED. 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.
Busca en YouTube, Instagram y Threads y recibe vídeos, publicaciones, comentarios, perfiles y subtítulos de YouTube en JSON desde cualquier clave de API, por 0,5 créditos por solicitud completada.
Dale a tu agente búsqueda web en una sola llamada: cada resultado llega con los pasajes de su página que responden a la consulta, por 0,5 créditos la búsqueda.