Interrogez ChatGPT et Gemini depuis un lieu précis

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.

{
  "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 status QUEUED. 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.

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

Erreurs

LOCATION_UNSUPPORTEDHTTP 422

payload.location fonctionne avec CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP. Les autres moteurs renvoient ce code dès l’envoi.

Tarif

Une tâche localisée coûte le même prix que toute autre tâche du moteur : 2 crédits pour ChatGPT et 1 crédit pour Gemini, par tâche terminée.