Die Antwortanalyse kostet jetzt 1 Credit

Eine Antwortaufgabe mit include.analysis liefert jede genannte Marke mit Rang, Empfehlung und Stimmung sowie die Art jeder zitierten Website, zum halben bisherigen Preis.

Was sich ändert

• Die Antwortanalyse kostet 1 Credit pro Aufgabe zusätzlich zum Engine-Preis (vorher: 2). Eine ChatGPT-Antwort mit Analyse kostet insgesamt 2 Credits.
• Jede zitierte Website erhält ein genaueres kind: editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video und institution für bekannte Websites. Jede andere Website wird einmal als brand, content oder einer dieser Arten eingeordnet, und das Ergebnis wird wiederverwendet.
• Eine Schreibweise, die die Analyse als eigenen Namen einer Marke bestätigt, etwa 컬리 für Kurly, wird gespeichert und in späteren Antworten per Regel gefunden.
• Die Analyse läuft bei Aufgaben vom Typ CHATGPT, GEMINI, PERPLEXITY, GOOGLE, AIMODE, NAVER_AI_BRIEF und NAVER_AI_TAB.

So funktioniert es

Ein Modell entscheidet, welche Namen Marken sind, welche davon Ihre ist, sowie recommended und sentiment. Positionen, Ränge, Namensabgleich und Quellenarten werden per Regel berechnet, sodass dieselbe Lesart dasselbe Ergebnis liefert.

Ihre Marke und Ihre Wettbewerber werden über Namen und Aliase mit den Regeln eines Monitors gefunden: ganze Wörter in lateinischer Schrift, an jeder Stelle in Koreanisch, Japanisch, Chinesisch und Thai. Das Modell liest die ersten 40.000 Zeichen der Antwort, und die Analyse verlängert die Aufgabe um einige Sekunden.

Einsatzbereiche

• Berechnen Sie Erwähnungsrate, durchschnittliche Position und Share of Voice über alle Prompts direkt aus analysis.targets.
• Vergleichen Sie mit recommended und sentiment, wie jede Engine über Ihre Marke und Ihre Wettbewerber spricht.
• Sehen Sie mit sources[].kind, welche Arten von Websites die Engines in Ihrer Kategorie zitieren und wo Ihre Website als owned erscheint.

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 CRM for a small team",
      "country": "US",
      "include": { "analysis": true },
      "brand": "Acme CRM",
      "brandAliases": ["Acme"],
      "brandDomains": ["acme-crm.example"],
      "competitors": [
        "Northwind",
        {
          "name": "Contoso CRM",
          "aliases": ["Contoso"],
          "domains": ["contoso-crm.example"]
        }
      ]
    }
  }'

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

Mit true kommt analysis hinzu: jede Marke, die die Antwort nennt, mit Rang, Empfehlung, Stimmung und der Art jeder zitierten Website. 1 Credit zusätzlich zum Engine-Preis.

payload.brandstring

Ihr Markenname, bis zu 200 Zeichen. Er erscheint in analysis.targets mit der Rolle brand.

payload.brandAliasesarray

Bis zu 20 weitere Namen, mit denen die Antwort Ihre Marke nennen kann. Nur zusammen mit brand.

payload.brandDomainsarray

Bis zu 20 Ihrer Websites, etwa acme-crm.example. Ein Zitat auf einer davon oder einer Subdomain hat kind owned. Nur zusammen mit brand.

payload.competitorsarray

Bis zu 50 Wettbewerber. Jeder ist ein Name oder { name, aliases, domains } mit bis zu 20 Aliasen und 20 Domains. Sie erscheinen in analysis.targets mit der Rolle competitor.

Antwort

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

{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "…",
    "analysis": {
      "version": 1,
      "status": "ok",
      "brands": [
        {
          "name": "Northwind",
          "rank": 1,
          "role": "competitor",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9
        },
        {
          "name": "Acme CRM",
          "rank": 2,
          "role": "brand",
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5
        },
        {
          "name": "Fabrikam",
          "rank": 3,
          "role": null,
          "recommended": false,
          "sentiment": "neutral",
          "sentimentScore": 0
        }
      ],
      "targets": [
        {
          "name": "Acme CRM",
          "role": "brand",
          "mentioned": true,
          "rank": 2,
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.5,
          "cited": true
        },
        {
          "name": "Northwind",
          "role": "competitor",
          "mentioned": true,
          "rank": 1,
          "recommended": true,
          "sentiment": "positive",
          "sentimentScore": 0.9,
          "cited": false
        },
        {
          "name": "Contoso CRM",
          "role": "competitor",
          "mentioned": false,
          "rank": null,
          "recommended": null,
          "sentiment": null,
          "sentimentScore": null,
          "cited": false
        }
      ],
      "sources": [
        {
          "position": 1,
          "url": "https://www.acme-crm.example/pricing",
          "domain": "acme-crm.example",
          "kind": "owned",
          "brand": "Acme CRM"
        },
        {
          "position": 2,
          "url": "https://www.g2.com/categories/crm",
          "domain": "g2.com",
          "kind": "reviews",
          "brand": null
        }
      ]
    }
  }
}

response.analysis.statusstring

ok, wenn die Analyse gelaufen ist, no_answer, wenn die Engine keinen Antworttext geliefert hat, und failed, wenn die Analyse nicht laufen konnte. Berechnet wird nur ok.

response.analysis.brandsarray

Jede Marke, die die Antwort nennt, in der Reihenfolge ihrer ersten Nennung. rank beginnt bei 1, ein Produkt zählt für seinen Hersteller. Jede hat recommended, sentiment und sentimentScore.

response.analysis.targetsarray

Die gesendeten Marken in Ihrer Reihenfolge, jeweils mit mentioned, ihrem rank in brands und cited, wenn eine ihrer Domains zitiert wird.

response.analysis.sources[].kindstring

Die Art jeder zitierten Website: owned und competitor aus Ihren Domains, sonst editorial, review_media, pr_wire, reviews, commerce, social, blog, community, video, institution, brand, content oder other.

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

Die Aufgabe reserviert beim Senden 1 Credit für die Analyse und berechnet ihn nur, wenn analysis.status ok ist. Bei no_answer oder failed wird der Credit freigegeben, und die Aufgabe endet mit ihrer Antwort. Pläne und Credit-Preise finden Sie unter https://querying.ai/pricing .