Interrogez ChatGPT et Gemini depuis un lieu précis
Answers
Avec payload.location, les tâches CHATGPT et GEMINI renvoient la réponse vue par un utilisateur sur place.
Ce que vous obtenez
Des réponses à l’échelle du quartier : les recommandations locales partent du point indiqué, comme une gare, une boutique ou un coin de rue.
location dans chaque résultat localisé : les coordonnées depuis lesquelles la question a été posée.
Le même réglage dans le Playground : saisissez un lieu ou des coordonnées dans Lieu (facultatif), à côté du bouton de pays.
Fonctionnement
Des questions comme « un bon dentiste près d’ici » ou « où déjeuner » dépendent de l’endroit où se trouve l’utilisateur. ChatGPT et Gemini y répondent selon sa position : le même prompt fait ressortir d’autres cliniques à Gangnam et à Busan. Indiquez dans payload.location un point situé dans le country de la tâche, et querying.ai interroge le moteur comme un utilisateur présent sur place.
Envoyez le point en latitude et longitude, en degrés décimaux, comme dans la requête ci-dessous. Les applications de cartes affichent ces nombres pour tout point choisi, et le Playground les trouve à partir d’un nom de lieu. Chaque résultat renvoie le même point dans location.
La localisation fonctionne sur les tâches CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP. L’API vérifie le moteur dès l’envoi et renvoie LOCATION_UNSUPPORTED pour tout autre moteur : chaque tâche exécutée répond donc pour le lieu choisi.
Cas d’usage
Vérifiez si l’IA recommande votre clinique, votre restaurant ou votre boutique aux habitants de son quartier.
Posez la même question depuis plusieurs quartiers ou villes pour voir où vos concurrents mènent.
Suivez chaque établissement d’une enseigne depuis sa propre adresse, avec un ensemble de prompts par lieu.
Envoyer la requête
Envoyez la requête avec votre clé API dans l’en-tête 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 }
}
}'
Champs de la requête
taskTypestringObligatoire
Le moteur à interroger, par exemple CHATGPT ou GOOGLE.
payload.promptstringObligatoire
La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.
payload.countrystring
Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.
payload.locationobject
Un point situé dans country, avec latitude (-90 à 90) et longitude (-180 à 180) en degrés décimaux, par exemple {"latitude": 37.4979, "longitude": 127.0276}. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.
webhook.urlstring
Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.
idempotencyKeystring
Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.
Réponse
Voici une tâche terminée, raccourcie pour la lecture.
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, puis COMPLETED avec la réponse ou FAILED avec error.
credits.creditsChargedinteger
Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.
response.textstring
La réponse en texte brut.
response.locationobject
Le point retenu pour la réponse, tel que vous l’avez envoyé : latitude et longitude.
response.sourcesarray
Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.
response.searchQueriesarray
Les recherches web lancées par le moteur pour rédiger la réponse.
Recevoir le résultat
La requête renvoie aussitôt la tâche avec statusQUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.
Recherchez sur YouTube, Instagram et Threads et recevez vidéos, publications, commentaires, profils et sous-titres YouTube en JSON depuis n’importe quelle clé API, pour 0,5 crédit par requête terminée.
Donnez la recherche web à votre agent en un seul appel : chaque résultat arrive avec les passages de sa page qui répondent à la requête, pour 0,5 crédit la recherche.