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 ponto que você indica, como uma estação, uma loja ou uma esquina.
• location em cada resultado com local: as coordenadas de onde a pergunta partiu.
• O mesmo controle no Playground: digite um lugar ou coordenadas 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 ponto dentro do country da tarefa, e o querying.ai pergunta ao mecanismo como um usuário que está ali.

Envie o ponto como latitude e longitude em graus decimais, como na requisição abaixo. Apps de mapas mostram esses números para qualquer ponto escolhido, e o Playground os encontra a partir do nome de um lugar. Cada resultado devolve o mesmo ponto em location.

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": { "latitude": 40.72288, "longitude": -73.99875 }
    }
  }'

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

Um ponto dentro de country, com latitude (-90 a 90) e longitude (-180 a 180) em graus decimais, por exemplo {"latitude": 37.4979, "longitude": 127.0276}. 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": { "latitude": 40.72288, "longitude": -73.99875 }
  }
}

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 ponto usado na resposta, como você o enviou: latitude e longitude.

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.

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.