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 lieu indiqué, comme une gare, un arrondissement ou une adresse.
• location dans chaque résultat localisé : le lieu utilisé par la réponse, ses coordonnées et le type de lieu reconnu.
• Le même réglage dans le Playground : saisissez le lieu 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 lieu situé dans le country de la tâche, et querying.ai interroge le moteur comme un utilisateur présent sur place.

Écrivez le lieu comme on l’écrit sur place, jusqu’à 200 caractères : « 강남역 », « Gangnam-gu, Seoul » ou une adresse complète. Pour un nom que partagent plusieurs villes, ajoutez l’arrondissement ou la ville. Le résultat indique ce qui a été appliqué :

• location.query : le texte envoyé.
• location.name : le lieu reconnu, écrit comme sur ce marché.
• location.latitude et location.longitude : le point pour lequel le moteur a répondu.
• location.precision : le type de lieu reconnu, par exemple railway, suburb ou city.

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

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

Un lieu situé dans country, comme une gare, un quartier ou une adresse, jusqu’à 200 caractères. 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": {
      "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, 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 lieu retenu pour la réponse : query, name, latitude, longitude et precision.

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.

LOCATION_NOT_FOUNDHTTP 422

Le lieu de payload.location est inconnu dans country. Ajoutez le quartier ou la ville, puis renvoyez la requête.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

La recherche de lieux est brièvement interrompue. Renvoyez la même requête : les lieux déjà trouvés sont traités aussitôt.

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.