Pergunte ao ChatGPT e ao Gemini a partir de uma localização exata

Use payload.location em tarefas CHATGPT e GEMINI para receber a resposta que um usuário vê naquele local.

O que você recebe

• Respostas de bairro: as recomendações locais partem do lugar que você indica, como uma estação, um distrito ou um endereço.
• location em cada resultado com local: o lugar que a resposta usou, as coordenadas e o tipo de lugar reconhecido.
• O mesmo controle no Playground: digite o lugar em Localização (opcional), ao lado do botão de país.

Como funciona

Perguntas como “um bom dentista por perto” ou “onde almoçar” dependem de onde o usuário está. O ChatGPT e o Gemini respondem conforme a localização do usuário, então o mesmo prompt traz clínicas diferentes em Gangnam e em Busan. Informe em payload.location um lugar dentro do country da tarefa, e o querying.ai pergunta ao mecanismo como um usuário que está ali.

Escreva o lugar como as pessoas de lá escrevem, com até 200 caracteres: “강남역”, “Gangnam-gu, Seoul” ou um endereço completo. Para um nome que várias cidades compartilham, acrescente o distrito ou a cidade. O resultado registra o que foi aplicado:

• location.query: o texto que você enviou.
• location.name: o lugar reconhecido, escrito como se escreve naquele mercado.
• location.latitude e location.longitude: o ponto para o qual o mecanismo respondeu.
• location.precision: o tipo de lugar reconhecido, como railway, suburb ou city.

A localização funciona em tarefas CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP. A API confere o mecanismo no momento do envio e devolve LOCATION_UNSUPPORTED para qualquer outro mecanismo, então cada tarefa executada responde para o lugar que você escolheu.

Onde ajuda

• Confira se a IA recomenda sua clínica, restaurante ou loja para as pessoas do próprio bairro.
• Faça a mesma pergunta a partir de vários bairros ou cidades para ver onde a concorrência lidera.
• Acompanhe cada unidade de uma rede a partir do próprio endereço, com um conjunto de prompts por local.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 da requisição

taskTypestringObrigatório

O motor que executa a tarefa, como CHATGPT ou GOOGLE.

payload.promptstringObrigatório

A pergunta, escrita como o usuário digita no chat. Até 100.000 caracteres.

payload.countrystring

Código de país de duas letras do mercado de onde a pergunta parte, como US, KR ou JP. Padrão US.

payload.locationstring

Um lugar dentro de country, como uma estação, um bairro ou um endereço, com até 200 caracteres. O motor responde como a um usuário que está ali. Para CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

idempotencyKeystring

Seu próprio ID para a requisição. Cada chave cria uma única tarefa por conta, então um reenvio continua sendo uma tarefa.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "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 e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.textstring

A resposta em texto puro.

response.locationobject

O lugar usado na resposta: query, name, latitude, longitude e precision.

response.sourcesarray

As páginas que a resposta cita, na ordem do motor, com position, url e label.

response.searchQueriesarray

As buscas na web que o motor fez para escrever a resposta.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

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

Erros

LOCATION_UNSUPPORTEDHTTP 422

payload.location funciona em CHATGPT, GEMINI, GOOGLE, AIMODE e GOOGLE_SERP. Os outros mecanismos devolvem este código no envio.

LOCATION_NOT_FOUNDHTTP 422

O lugar de payload.location é desconhecido dentro de country. Acrescente o bairro ou a cidade e envie de novo.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

A busca de lugares está parada por um instante. Reenvie a mesma requisição e os lugares já encontrados são resolvidos na hora.

Preço

Uma tarefa com local custa o mesmo que qualquer outra do mecanismo: 2 créditos no ChatGPT e 1 crédito no Gemini por tarefa concluída.