Stellen Sie ChatGPT eine Frage aus dem Markt Ihrer Wahl und erhalten Sie als JSON die Antwort, die echte Besucher dort sehen, mit allen zitierten Quellen.
Was Sie erhalten
text und markdown: die vollständige Antwort als reiner Text und mit Formatierung.
sources: jede Seite, die die Antwort zitiert, in Reihenfolge, mit URL und Titel.
searchQueries: die Websuchen, die ChatGPT für die Antwort ausgeführt hat. So sehen Sie, wie es Ihren Prompt recherchiert hat.
model: das Modell, das in dieser Sitzung geantwortet hat.
So funktioniert es
Jede Aufgabe öffnet eine neue ChatGPT-Sitzung im gewählten Land und stellt Ihre Frage genau so, wie Sie sie geschrieben haben. Sie erhalten die Antwort, die ein Erstbesucher in diesem Markt bekommt. Die empfohlenen Marken und zitierten Seiten entsprechen also dem, was Ihre Kunden lesen.
Jeder Lauf ist eine neue Beobachtung. Wiederholen Sie dieselben Prompts regelmäßig und vergleichen Sie die Läufe, um zu sehen, wie sich Antwort, empfohlene Marken und zitierte Seiten über die Zeit verändern.
Einsatzbereiche
Prüfen Sie, ob ChatGPT Ihre Marke bei den Fragen Ihrer Käufer empfiehlt.
Finden Sie die Seiten, die ChatGPT in Ihrer Kategorie zitiert, und planen Sie Inhalte darauf aufbauend.
Vergleichen Sie die Antwort auf denselben Prompt zwischen Ländern.
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": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
"country": "US"
}
}'
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.locationobject
Ein Punkt innerhalb von country, mit latitude (-90 bis 90) und longitude (-180 bis 180) in Dezimalgrad, etwa {"latitude": 37.4979, "longitude": 127.0276}. Die Engine antwortet wie einem Nutzer vor Ort. Für CHATGPT, GEMINI, GOOGLE, AIMODE und GOOGLE_SERP.
payload.include.markdownboolean
Liefert markdown, die Antwort mit Überschriften, Listen, Tabellen und Links. Standardmäßig aktiv.
payload.include.searchQueriesboolean
Liefert searchQueries, die Websuchen, die ChatGPT für die Antwort ausgeführt hat. Standardmäßig aktiv.
payload.include.shoppingboolean
Liefert die Produktkarten, die ChatGPT zeigt, als shoppingCards. Standardmäßig aktiv.
payload.include.rawResponseboolean
Mit true kommt die Rohausgabe der Engine neben dem strukturierten Ergebnis hinzu, für Ihr eigenes Parsing. Standardmäßig aus.
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.
JSON
{
"success": true,
"task": {
"id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
"taskType": "CHATGPT",
"status": "COMPLETED",
"createdAt": "2026-09-10T02:34:15.604Z"
},
"credits": { "creditsToCharge": 2, "creditsCharged": 2 },
"response": {
"text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
"markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
"sources": [
{
"position": 1,
"url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
"label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
"attribution": "WIRED",
"datePublished": "March 29, 2026"
},
{
"position": 2,
"url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
"label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
"attribution": "Tom's Guide",
"datePublished": "July 24, 2026"
}
],
"searchQueries": [
"best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
]
}
}
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.markdownstring
Die Antwort mit ihrer Formatierung: Überschriften, Listen, Tabellen und Links.
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.
response.shoppingCardsarray
Produktkarten zur Antwort: Titel, Preis, Shop, Bewertung und Produktlink.
Ergebnis abholen
Die Anfrage liefert sofort die Aufgabe mit statusQUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis statusCOMPLETED 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.
Durchsuchen Sie YouTube, Instagram und Threads und erhalten Sie Videos, Beiträge, Kommentare, Profile und YouTube-Untertitel als JSON mit jedem API-Schlüssel, für 0,5 Credits pro abgeschlossener Anfrage.
Geben Sie Ihrem Agenten Websuche mit einem Aufruf: Jedes Ergebnis kommt mit den Passagen seiner Seite, die die Anfrage beantworten, für 0,5 Credits pro Suche.