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 lugar que indicas, como una estación, un distrito o una dirección.
• location en cada resultado con lugar: el lugar que usó la respuesta, sus coordenadas y el tipo de lugar que coincidió.
• El mismo control en el Playground: escribe el lugar 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 lugar dentro del country de la tarea, y querying.ai pregunta al motor como un usuario que está allí.

Escribe el lugar como lo escriben allí, con hasta 200 caracteres: “강남역”, “Gangnam-gu, Seoul” o una dirección completa. Cuando varias ciudades comparten el nombre, añade el distrito o la ciudad. El resultado registra lo que se aplicó:

• location.query: el texto que enviaste.
• location.name: el lugar que coincidió, escrito como se escribe en ese mercado.
• location.latitude y location.longitude: el punto para el que respondió el motor.
• location.precision: el tipo de lugar que coincidió, como railway, suburb o city.

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": "SoHo, New York"
    }
  }'

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.

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": {
      "name": "SoHo, Manhattan, New York County, New York, 10012, United States",
      "query": "SoHo, New York",
      "latitude": 40.72288,
      "longitude": -73.99875,
      "precision": "neighbourhood"
    }
  }
}

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 lugar que usó la respuesta: query, name, latitude, longitude y precision.

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.

LOCATION_NOT_FOUNDHTTP 422

El lugar de payload.location es desconocido dentro de country. Añade el distrito o la ciudad y vuelve a enviarlo.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

La búsqueda de lugares está detenida un momento. Reenvía la misma solicitud y los lugares ya encontrados se resuelven al instante.

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.