Fragen Sie ChatGPT und Gemini von einem genauen Ort aus

Mit payload.location liefern CHATGPT- und GEMINI-Aufgaben die Antwort, die jemand an diesem Ort sieht.

Was Sie erhalten

• Antworten für ein Viertel: Lokale Empfehlungen beziehen sich auf die Umgebung des Ortes, den Sie angeben, etwa einen Bahnhof, einen Bezirk oder eine Adresse.
• location in jedem Ergebnis mit Ort: der Ort, den die Antwort verwendet hat, seine Koordinaten und die Art des erkannten Ortes.
• Dieselbe Einstellung im Playground: Geben Sie den Ort unter Ort (optional) neben der Länder-Schaltfläche ein.

So funktioniert es

Fragen wie „ein guter Zahnarzt in der Nähe“ oder „wo esse ich zu Mittag“ hängen davon ab, wo sich die Person befindet. ChatGPT und Gemini beantworten sie für ihren Standort, deshalb nennt derselbe Prompt in Gangnam andere Praxen als in Busan. Setzen Sie payload.location auf einen Ort innerhalb des country der Aufgabe, und querying.ai fragt die Engine wie jemand, der genau dort steht.

Schreiben Sie den Ort so, wie man ihn dort schreibt, mit bis zu 200 Zeichen: „강남역“, „Gangnam-gu, Seoul“ oder eine vollständige Adresse. Teilen sich mehrere Städte einen Namen, ergänzen Sie den Bezirk oder die Stadt. Das Ergebnis hält fest, was angewendet wurde:

• location.query: der Text, den Sie gesendet haben.
• location.name: der erkannte Ort, so geschrieben, wie man ihn in diesem Markt schreibt.
• location.latitude und location.longitude: der Punkt, für den die Engine geantwortet hat.
• location.precision: die Art des erkannten Ortes, etwa railway, suburb oder city.

Der Ort funktioniert bei CHATGPT-, GEMINI-, GOOGLE-, AIMODE- und GOOGLE_SERP-Aufgaben. Die API prüft die Engine direkt beim Absenden und antwortet für jede andere Engine mit LOCATION_UNSUPPORTED. So antwortet jede ausgeführte Aufgabe für den Ort, den Sie gewählt haben.

Einsatzbereiche

• Prüfen Sie, ob KI Ihre Praxis, Ihr Restaurant oder Ihr Geschäft den Menschen im eigenen Viertel empfiehlt.
• Stellen Sie dieselbe Frage aus mehreren Vierteln oder Städten und sehen Sie, wo Wettbewerber vorn liegen.
• Verfolgen Sie jede Filiale einer Kette von ihrer eigenen Adresse aus, mit einem Prompt-Set pro Standort.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header 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"
    }
  }'

Felder der Anfrage

taskTypestringPflicht

Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.

payload.promptstringPflicht

Die Frage, so formuliert, wie ein Nutzer sie in den Chat tippt. Bis zu 100.000 Zeichen.

payload.countrystring

Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.

payload.locationstring

Ein Ort innerhalb von country, etwa ein Bahnhof, ein Viertel oder eine Adresse, bis zu 200 Zeichen. Die Engine antwortet wie einem Nutzer vor Ort. Für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP.

webhook.urlstring

Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.

idempotencyKeystring

Ihre eigene ID für die Anfrage. Jeder Schlüssel erzeugt pro Konto genau eine Aufgabe, ein wiederholter Versand bleibt also eine Aufgabe.

Antwort

So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.

{
  "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, dann COMPLETED mit der Antwort oder FAILED mit error.

credits.creditsChargedinteger

Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.

response.textstring

Die Antwort als reiner Text.

response.locationobject

Der Ort, für den die Antwort gilt: query, name, latitude, longitude und precision.

response.sourcesarray

Die Seiten, die die Antwort zitiert, in der Reihenfolge der Engine, mit position, url und label.

response.searchQueriesarray

Die Websuchen, die die Engine für die Antwort ausgeführt hat.

Ergebnis abholen

Die Anfrage liefert sofort die Aufgabe mit status QUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis status COMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.

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

Fehler

LOCATION_UNSUPPORTEDHTTP 422

payload.location gilt für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP. Andere Engines liefern diesen Code beim Senden.

LOCATION_NOT_FOUNDHTTP 422

Der Ort in payload.location ist innerhalb von country unbekannt. Ergänzen Sie Bezirk oder Stadt und senden Sie erneut.

LOCATION_LOOKUP_UNAVAILABLEHTTP 503

Die Ortssuche ist kurz unterbrochen. Senden Sie dieselbe Anfrage erneut, bereits gefundene Orte werden sofort verarbeitet.

Preis

Eine Aufgabe mit Ort kostet so viel wie jede andere Aufgabe der Engine: 2 Credits bei ChatGPT und 1 Credit bei Gemini pro abgeschlossener Aufgabe.