ChatGPT-Karten kommen jetzt mit ihrem Detailbereich

Aktivieren Sie include.entityDetails bei einer ChatGPT-Aufgabe und erhalten Sie ohne Aufpreis den Bereich, den ChatGPT für jede Produkt-, Orts- oder Markenkarte der Antwort öffnet, mit Text, Quellen und Bildern.

Was Sie erhalten

• payload.include.entityDetails: true bei CHATGPT-Aufgaben.
• entityDetails an der Antwort und an jeder Antwort in followUps: ein Eintrag pro Karte, die die Antwort nennt, bis zu 20.
• Jeder Eintrag enthält name, category (product, local_business, software, organization, brand und weitere), query, status, markdown, sources, products, images und complete.
• sources listet die Websites, die der Bereich zitiert, mit position, url, label, site und description.

So funktioniert es

Wenn ein Nutzer in einer ChatGPT-Antwort auf eine Produkt-, Orts- oder Markenkarte klickt, öffnet ChatGPT einen Bereich und schreibt ein kurzes Profil, mit den Websites, die es gelesen hat, als Quellen. Nach der Antwort wird derselbe Bereich für jede Karte angefragt, im selben Gespräch, jeweils vier Karten gleichzeitig. Der Detailschritt verlängert eine Antwort um etwa 10 Sekunden.

markdown ist der Bereich so, wie ChatGPT ihn geschrieben hat, mit Überschriften, Listen und Quellenlinks. complete: false heißt, dass ChatGPT vor dem Ende des Bereichs aufgehört hat; Text und Quellen bis dahin bleiben erhalten.

Jede Karte wird für sich verarbeitet. Eine fehlgeschlagene Karte trägt status: "failed" und einen error (ENTITY_DETAIL_FAILED oder ENTITY_DETAIL_EMPTY), und die Antwort und die übrigen Karten werden wie gewohnt fertig. Bei Aufgaben mit location, CN oder HK kommen die Karten mit ENTITY_DETAIL_UNAVAILABLE zurück.

include.entityDetails funktioniert bei CHATGPT und wird ohne include.html gesendet. An eine andere Engine oder zusammen mit include.html gesendet, antwortet die API mit 422 VALIDATION_ERROR, bevor Credits reserviert werden.

Einsatzbereiche

• Lesen Sie, wie ChatGPT Ihr Produkt beschreibt, wenn ein Käufer auf seine Karte klickt, und prüfen Sie die Daten, Preise und Aussagen, die es wiedergibt.
• Sehen Sie, welche Websites ChatGPT für Ihr Produkt und für jeden Wettbewerber zitiert, und planen Sie Tests und Listings rund um diese Websites.
• Stellen Sie dieselbe Frage in mehreren Ländern und vergleichen Sie, wie der Bereich jedes Markts dieselbe Marke vorstellt.

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": "What is the best robot vacuum for pet hair?",
      "country": "US",
      "include": { "entityDetails": true }
    }
  }'

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.include.entityDetailsboolean

Mit true kommt entityDetails hinzu: der Detailbereich, den ChatGPT für jede Karte der Antwort öffnet. Für CHATGPT, ohne include.html. Standardmäßig aus, ohne zusätzliche Credits.

payload.followUpsarray

Bis zu 4 weitere Runden im selben ChatGPT-Chat nach der ersten Antwort. Jeder Eintrag ist {"prompt": "…"} für eine Frage oder {"select": {…}}, um eine Schaltfläche im Formular der vorigen Antwort zu drücken. Für CHATGPT.

webhook.urlstring

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

Antwort

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

{
  "success": true,
  "task": {
    "id": "a81e4b26-b4c0-48eb-b20b-10efbd327f1a",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T04:40:09.819Z"
  },
  "response": {
    "text": "For most pet owners, I’d start with the **Dreame L40 Ultra Gen 2**. It offers a strong mix of pet-hair pickup, anti-tangle features, automatic dust emptying, and minimal day-to-day maintenance without necessarily requiring a flagship-level budget. …",
    "model": "gpt-6",
    "entityDetails": [
      "…",
      {
        "name": "Roborock Saros 20",
        "category": "product",
        "query": "Roborock Saros 20",
        "status": "ok",
        "markdown": "The **Roborock Saros 20** is Roborock's 2026 flagship robot vacuum and mop. It focuses on high-end automation with powerful vacuuming, dual spinning mop pads, advanced obstacle avoidance, an ultra-slim body for cleaning under furniture, and a dock that automates most maintenance tasks. …",
        "sources": [],
        "images": [],
        "complete": true
      },
      {
        "name": "MOVA P50 Pro Ultra",
        "category": "product",
        "query": "MOVA P50 Pro Ultra",
        "status": "ok",
        "markdown": "## MOVA P50 Pro Ultra\n\nThe **MOVA P50 Pro Ultra** is a premium robot vacuum and mop introduced as MOVA's 2025 flagship model. … ([RTINGS.com +1](https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com))\n\n### Key features\n\n- **19,000 Pa suction power**\n- **Dual rotating mop pads**\n…",
        "sources": [
          {
            "position": 1,
            "url": "https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Review - RTINGS.com",
            "site": "RTINGS.com"
          },
          {
            "position": 2,
            "url": "https://us.mova.tech/products/mova-p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Robot Vacuum and Mop Combo | MOVA US",
            "site": "MOVA-US"
          },
          {
            "position": 3,
            "url": "https://www.idealhome.co.uk/house-manual/floorcare/mova-p50-pro-ultra-robot-vacuum-review?utm_source=chatgpt.com",
            "label": "I've spent years telling people that robot mops aren't worth the money - the MOVA P50 Pro Ultra is the first one to change my mind",
            "site": "Ideal Home",
            "description": "The review provides a detailed assessment of the MOVA P50 Pro Ultra Robot Vacuum, marking a pivotal shift in the author's long-standing skepticism toward robot mops. …"
          },
          "…"
        ],
        "images": [],
        "complete": true
      },
      "…"
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.

response.textstring

Die Antwort als reiner Text.

response.entityDetailsarray

Ein Bereich pro Karte, bis zu 20: name, category, query, status (ok oder failed), markdown, sources, products, images und complete. Eine fehlgeschlagene Karte hat einen error, und die Antwort wird trotzdem fertig.

response.followUpsarray

Eine Antwort pro Folgefrage, in Reihenfolge. Jeder Eintrag enthält den gesendeten prompt, bei select die selection (Schaltfläche und Werte) und die Felder der ersten Antwort, etwa text, markdown, sources, searchQueries und model.

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

VALIDATION_ERRORHTTP 422

include.entityDetails wurde an eine andere Engine als CHATGPT, zusammen mit include.html oder mit einem Wert gesendet, der kein Boolean ist. details nennt payload.include.entityDetails.

MISSING_API_KEYHTTP 401

Der Header Authorization fehlt, oder sein Schlüssel ist unbekannt, abgelaufen oder widerrufen.

INSUFFICIENT_CREDITSHTTP 402

Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.

Preis

Kartendetails sind kostenlos. Eine ChatGPT-Aufgabe kostet mit und ohne include.entityDetails gleich viel: 1 Credit pro Antwort, auch für jede Antwort auf eine Folgefrage.