Neu: Sichtbarkeitsanalyse in Citation Analysis

Citation Analysis zeigt jetzt, auf welche Seiten sich eine KI-Antwort stützt, wo Ihre Marke steht und was zu tun ist, beginnend mit Ihrer eigenen Website.

Was sich ändert

• queries: die Suchen der Engine, jeweils mit den gefundenen Seiten.
• sources: jede abgerufene Seite, mit cited zur Trennung zitierter Seiten, ihrer position in der Suche, den Passagen, die die Engine als zitiert meldet, den Marken auf der Seite und einem channel, der angibt, wer sie kontrolliert: Ihre Website, eine andere Marke, ein Verlag, ein Händler, eine Bewertungsplattform, eine Community, Video, Social Media, eine Blogplattform oder ein Nachschlagewerk.
• brands: Ihre Marke, Ihre Wettbewerber und jede Marke aus der Antwort, in der Reihenfolge der Antwort, mit den zitierten und abgerufenen Seiten, die sie nennen.
• visibility: die Stufe, die Ihre Marke erreicht hat, von in der Antwort genannt bis auf keiner gelesenen Seite gefunden.
• actions: was zu tun ist, geordnet danach, wie viel in Ihrer Hand liegt: zuerst Ihre eigenen Seiten, dann Plattformen, auf denen Sie veröffentlichen können, zuletzt Verlage, die Sie ansprechen. Jede Aktion hat konkrete steps und die Seiten dahinter.
• insights: was die zitierten Seiten gemeinsam haben, etwa Kanal, Format, Aktualität und Kriterien, und wo Ihre Marke steht, jeweils mit den zugrunde liegenden Seiten und Links.

Die Antwort von POST /v1/citation-analysis enthält jetzt version: 4 und diese neuen Felder. links behält seine Form, jedes Insight nennt neben linkIds seine Seiten in sourceIds, und Ergebnisse, die vor dieser Änderung gespeichert wurden, behalten ihre gespeicherte Form. Das Produkt heißt jetzt Citation Analysis: /v1/source-influence und /v1/geo-audit, die taskTypes SOURCE_INFLUENCE und GEO_AUDIT sowie include.sourceInfluence und include.geoAudit funktionieren weiter, Antworten verwenden /v1/citation-analysis, CITATION_ANALYSIS und citationAnalysis.

So funktioniert es

Mit einer taskId stammen Suchen und abgerufene Seiten direkt aus der Antwortaufgabe, wenn die Engine sie offenlegt, etwa ChatGPT und Google AI Overview. Sie können sie auch selbst in queries und als citations mit cited: false senden. Andere Engines liefern zitierte Seiten.

Empfehlungen stammen meist von Drittseiten. In den untersuchten ChatGPT-Antworten rief die Engine im Median 20 Seiten ab und zitierte 3, und die eigene Website einer empfohlenen Marke wurde in 16 % der Fälle abgerufen und in 6,8 % zitiert. Die Aktionen folgen diesem Weg und beginnen bei dem, was Sie selbst in der Hand haben:

• improve_page: Ihre Seite, die die Engine abgerufen und übergangen hat oder die zitiert wurde, während die Antwort Ihre Marke auslässt, mit dem, was Sie ergänzen sollten, damit sie den Prompt wie die zitierten Seiten beantwortet.
• publish_page: ein Briefing für eine neue Seite auf Ihrer Website zu einer Suche, bei der keine Ihrer Seiten zitiert wurde, nach dem Vorbild der zitierten Seiten: Seitentyp, Titelmuster, Abschnitte, Belege und Datum.
• post_on_platform: eine Händler-, Bewertungs-, Community-, Video- oder Social-Media-Seite, die Ihre Wettbewerber nennt, mit Schritten wie Ihr Angebot vervollständigen, echte Kunden um Bewertungen bitten oder als erkennbare Markenvertretung antworten.
• pitch_publisher: eine zitierte redaktionelle Seite, die nur ihr Verlag ändern kann, mit dem, was Sie ihm schicken sollten.

Jede Zuordnung zeigt, welche Seite sagt, was die Antwort sagt, und jede Aktion zeigt auf die genauen Seiten, auf denen sie beruht. Die Stufe not_found bedeutet, dass keine gelesene Seite Ihre Marke nennt. Senden Sie brand, um visibility und actions zu erhalten, und ergänzen Sie brandDomains und brandAliases, damit Ihre eigenen Seiten und weiteren Namen zählen.

Einsatzbereiche

• Beginnen Sie bei Ihrer eigenen Website: Überarbeiten Sie die Seite, die die Engine übergangen hat, oder planen Sie eine neue nach dem Vorbild der zitierten Seiten.
• Geben Sie Ihrem Marktplatz- und Community-Team die Angebote und Threads, in denen Wettbewerber auftauchen.
• Sprechen Sie Verlage mit der genauen Seite und den Passagen an, die die Antwort übernommen hat.

Anfrage senden

Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header Authorization.

curl -X POST https://api.querying.ai/v1/citation-analysis \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "…",
    "brand": "Blueair",
    "competitors": ["Coway", "Levoit"],
    "brandDomains": ["blueair.com"]
  }'

Felder der Anfrage

taskIdstringPflicht

Eine abgeschlossene Antwortaufgabe von Ihnen. Ihre Antwort und zitierten Seiten werden zu answer und citations.

brandstring

Ihr Markenname. Damit enthält das Ergebnis zusätzlich visibility und actions.

competitorsarray

Namen der Wettbewerber, die in der Antwort und ihren Seiten verfolgt werden.

brandDomainsarray

Bis zu 10 Hostnamen Ihrer eigenen Websites, etwa coway.com. Deren Seiten gelten als own.

brandAliasesarray

Bis zu 10 weitere Namen Ihrer Marke, etwa Produktlinien oder lokale Schreibweisen.

citations[].citedboolean

Standard true. Senden Sie false für eine Seite, die die Engine abgerufen, aber nicht zitiert hat, mit position und query, falls vorhanden.

countrystring

Land, aus dem die zitierten Seiten gelesen werden. Standard US.

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": "…",
    "taskType": "CITATION_ANALYSIS",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": "…", "creditsCharged": "…" },
  "response": {
    "version": 4,
    "answer": "The best-reviewed air purifiers depend on whether you …",
    "queries": [
      {
        "id": "q0",
        "text": "best air purifiers 2026 reviews independent testing …",
        "sourceIds": ["s0", "s1", "s2", "…", "s20"]
      }
    ],
    "sources": [
      {
        "id": "s13",
        "url": "https://www.blueair.com/products/blue-pure-211i-max",
        "domain": "blueair.com",
        "channel": "own",
        "cited": false,
        "position": 14,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [],
        "brandIds": ["b0"],
        "own": true,
        "paragraphs": []
      },
      {
        "id": "s14",
        "url": "https://www.target.com/p/levoit-core-300-air-…",
        "domain": "target.com",
        "channel": "retailer",
        "cited": true,
        "position": 15,
        "queryIds": ["q0"],
        "publishedAt": null,
        "citedText": [
          "A compact, straightforward option with a 4.6/5 rating …"
        ],
        "brandIds": ["b2"],
        "own": false,
        "paragraphs": [
          {
            "id": "s14p1",
            "text": "Levoit Core 300 Air Purifier White … $99.99 …"
          }
        ]
      },
      "…"
    ],
    "brands": [
      {
        "id": "b0",
        "name": "Blueair",
        "role": "target",
        "rank": 2,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s11"],
        "retrievedSourceIds": ["s5", "s6", "s8", "s9", "s13"],
        "ownSourceIds": ["s11", "s13"]
      },
      {
        "id": "b1",
        "name": "Coway",
        "role": "competitor",
        "rank": 1,
        "answerRanges": ["…"],
        "citedSourceIds": ["s1", "s3", "s4", "s7"],
        "retrievedSourceIds": ["s0", "s5", "s6", "s9", "s10", "s18"],
        "ownSourceIds": []
      },
      {
        "id": "b2",
        "name": "Levoit",
        "role": "competitor",
        "rank": 3,
        "answerRanges": ["…"],
        "citedSourceIds": ["s3", "s7", "s14"],
        "retrievedSourceIds": ["s6", "s15", "s16"],
        "ownSourceIds": []
      },
      "…"
    ],
    "links": [
      {
        "id": "l40",
        "paragraphId": "s14p1",
        "answerRanges": ["…"],
        "explanation": "Lists the Levoit Core 300 at $99.99, …"
      },
      "…"
    ],
    "visibility": {
      "brandId": "b0",
      "stage": "mentioned",
      "rank": 2,
      "answerBrands": 5
    },
    "actions": [
      {
        "id": "a0",
        "type": "improve_page",
        "control": "owned",
        "priority": 1,
        "summary": "Update Blueair’s site with a current, …",
        "steps": [
          "Add a page on best air purifiers in 2026 that covers …",
          "Include Blueair models in direct comparisons using published …",
          "…"
        ],
        "sourceIds": ["s13"],
        "brandIds": ["b0"],
        "queryIds": ["q0"],
        "linkIds": []
      },
      {
        "id": "a1",
        "type": "post_on_platform",
        "control": "platform",
        "priority": 2,
        "summary": "Improve Blueair’s Target product listing with …",
        "steps": [
          "Ensure the Blueair listing clearly states the model, current …",
          "…",
          "Keep product details current and invite genuine purchasers to …"
        ],
        "sourceIds": ["s14"],
        "brandIds": ["b2"],
        "queryIds": ["q0"],
        "linkIds": ["l40"]
      },
      "…"
    ],
    "insights": [
      {
        "summary": "Blueair’s second-place position is reflected in …",
        "sourceIds": ["s1", "s3", "s11"],
        "linkIds": ["l1", "l12", "l36"]
      },
      "…"
    ]
  }
}

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

Die Form des Ergebnisses. 4 für Analysen mit Suchanfragen, abgerufenen Seiten, Marken und Aktionen.

response.answerstring

Die gesendete Antwort, unverändert. Bereiche sind UTF-16-Offsets in genau diesem Text.

response.queriesarray

Die Suchen der Engine, jeweils mit id, ihrem text und den gefundenen sourceIds.

response.sourcesarray

Jede Seite, die die Engine abgerufen hat. cited trennt zitierte Seiten vom Rest, und channel gibt an, wer die Seite kontrolliert (own, brand, editorial, retailer, review_platform, community, video, social, blog_platform oder reference). Dazu kommen position, queryIds, citedText, brandIds und own. Zitierte Seiten enthalten paragraphs.

response.brandsarray

Ihre Marke, Ihre Wettbewerber und die Marken aus der Antwort, jeweils mit role, rank in der Antwort, answerRanges und den zitierten und abgerufenen Seiten, die sie nennen.

response.linksarray

Jeder Link verbindet einen Absatz mit den passenden answerRanges und einer explanation in einem Satz.

response.visibilityobject

Wie weit Ihre Marke kam: stage ist mentioned, on_cited_page, on_retrieved_page oder not_found, mit rank und answerBrands. null ohne brand.

response.actionsarray

Was zu tun ist, nach priority: zuerst owned-Arbeit auf Ihrer Website (improve_page, publish_page), dann platform-Beiträge (post_on_platform), zuletzt outreach (pitch_publisher). Jede Aktion hat ihre control, eine summary, 1 bis 5 steps und die zugrunde liegenden Quellen, Marken, Suchen und Links. Leer ohne brand.

response.insightsarray

Bis zu 4 kurze Einordnungen, was die zitierten Seiten gemeinsam haben und wo Ihre Marke steht, jeweils mit den Seiten in sourceIds und den Links in linkIds.

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"

Preis

Der Preis bleibt gleich: Credits werden beim Start der Analyse reserviert und nach Abschluss abgerechnet.