prompts[] steht in empfohlener Reihenfolge, und brands[] zeigt, welche Marken im selben
Bereich Suchnachfrage auf sich ziehen. Nutzen Sie die Prompts, um Inhalte zu planen, sie an
Antwort-Engines zu senden oder die Antworten in einem GEO-Monitor zu
verfolgen.
Wie die Prompts entstehen
- Produktarten. Die Keyword-Daten des Markts zeigen, nach welchen Produktarten Menschen unter dem Thema suchen,
etwa
sunscreen stickuntersunscreen. Das sind diecores[]im Ergebnis. - Bedingungen. Für jede Produktart findet die Recherche die Fragen, die die Wahl eines Käufers eingrenzen, etwa
Hauttyp, Budget oder Teamgröße. Das sind die
cores[].questionsim Ergebnis. Ihre Optionen werden zu Bedingungen, zusammen mit den Varianten, nach denen Menschen suchen (tinted sunscreen,sunscreen for oily skin). - Prompts. Die Bedingungen werden bis zu
depthzu Prompts kombiniert, jeder mit seinen gemessenen oder geschätzten Suchanfragen, in empfohlener Reihenfolge.
Recherche-Task einreichen
GET /v1/async/task/{id} oder geben Sie webhook.url in der Anfrage an und
erhalten Sie es, sobald der Task fertig ist. Der Task funktioniert wie jeder andere
asynchrone Task; das Ergebnis steht in response. Das Anfrageschema finden Sie in
der API-Referenz.
Reichen Sie Prompt Research nur über
POST /v1/prompt-research ein. POST /v1/async/task
lehnt taskType: "PROMPT_RESEARCH" ab.Anfragefelder
Der Body ist flach: Recherchefelder und Task-Optionen stehen auf oberster Ebene.Märkte
USschreibt Prompts auf Englisch. Die Nachfrage ist der Monatsdurchschnitt der letzten 12 Monate (demandSource.period: "monthly_average_last_12_months"), daher liegt ein saisonaler Begriff auf seinem Höhepunkt unter den Suchanfragen dieses Monats.KRschreibt Prompts auf Koreanisch. Die Nachfrage zählt die letzten 30 Tage (demandSource.period: "last_30_days"). Der Seed wird mit koreanischen Suchdaten abgeglichen; senden Sie ihn daher so, wie koreanische Nutzer ihn schreiben.
language im Ergebnis ist en für US und ko für KR.
Tiefe
depth legt fest, wie viele Bedingungen ein Prompt kombiniert, und jede Tiefe bis zu diesem Wert erscheint in
prompts:
Die Optionen einer Frage sind Alternativen: Ein Prompt kombiniert fettige Haut mit einem Budget, nie mit trockener
Haut. Jede Tiefe braucht mindestens einen Prompt, daher muss
limit mindestens depth + 1 sein. depth: 0
liefert die einfache Anfrage jeder Produktart und die Fragen, nach denen Menschen zum Thema suchen.
Ergebnis lesen
Einsunscreen-Lauf in den USA liefert zum Beispiel ein Ergebnis wie dieses, auf wenige Einträge gekürzt:
prompts[]
Die Prompts in empfohlener Reihenfolge, bis zu limit Einträge. Die Prompts jedes
Cores beginnen mit seiner einfachen Anfrage und seinen zwei Preisstufen und folgen dann nach Nachfrage über alle Tiefen
hinweg. Die Cores wechseln sich im Verhältnis ihrer Suchanfragen ab, alle einfachen Anfragen zuerst, sodass jeder Anfang
der Liste so verteilt ist wie die ganze Liste. Fragen, mit denen sich Menschen über das Thema informieren
(intent: "informational"), machen etwa ein Fünftel der Liste aus, wenn die Recherche sie findet, weil Käufer sie
stellen, bevor sie sich entscheiden. Um nur nach Nachfrage zu ordnen, sortieren Sie nach monthlySearchVolume.
cores[]
Die untersuchten Produktarten, die des Seeds zuerst. Senden Sie cores in der Anfrage, um Produktarten Ihrer Wahl zu
untersuchen.
brands[] und weitere Felder
brands[] listet Marken, Hersteller und Produktlinien, nach denen in diesem Bereich gesucht wird, mit ihrem
monthlySearchVolume. Ihre Nachfrage fließt nicht in prompts ein, weil Prompts keine Marken nennen. Nutzen Sie
sie als Wettbewerber, mit denen Sie Ihre Marke vergleichen.
Prompts an Ihrer Marke messen
Senden Siebrand zusammen mit brandDescription, und jeder Prompt erhält ein fit:
core: Laut Beschreibung bietet Ihre Marke, wonach der Prompt fragt.related: alles, was die Beschreibung nicht erwähnt.
limit enthalten. fit stellt die Prompts, die Ihre
Marke beantwortet, weiter nach vorn; die Nachfragezahlen bleiben gleich.
fit zum Beispiel so:
related. Um ein Unterthema ganz aus dem Ergebnis herauszuhalten, nutzen Sie exclude.
Von der Recherche zum Monitor
Um zu verfolgen, wie oft KI-Antworten Ihre Marke bei diesen Prompts nennen, übergeben Sieprompts[] an
POST /v1/monitors. Dieses Beispiel
nimmt den fertigen Recherche-Task, verwendet seine Prompts als Prompts des Monitors und die ersten zehn brands[] als
Wettbewerber (ein Marken-Monitor akzeptiert bis zu 10) und erstellt einen täglichen Marken-Monitor:
tasksPerRun
Ihres Kontos erlaubt (200 bei einem Self-Service-Konto; GET /v1/monitors/capabilities meldet Ihres), gezählt pro
Engine als Prompts × Standortpunkte × samples. Vierzig Prompts auf fünf Engines mit je einem Punkt und einem Sample
sind 200 Tasks.
Für einen Kategorie-Monitor senden Sie "mode": "CATEGORY" mit einer category und ordnen, wenn die Recherche
mehr als einen Core hat, jedem Prompt in promptTopics seinen core zu. Beide Arten und die vollständige Anfrage
finden Sie unter Monitore.
Die Zahlen lesen
- Tiefe 0 und 1 sind gemessen. Eine einfache Anfrage trägt die Suchanfragen ihrer Produktart, ein Prompt mit einer
Bedingung die Suchanfragen seines Keywords (
conditions[0].keyword). - Ab Tiefe 2 sind die Zahlen geschätzt. Ein Prompt mit zwei oder mehr Bedingungen wird selten wörtlich gesucht,
daher ist seine Zahl eine Schätzung (
volumeBasis: "estimated"). Nutzen Sie die Schätzungen, um Prompts zu ranken. - Breitere Prompts enthalten engere. Die Suchanfragen für sunscreen enthalten die für mineral sunscreen; addieren Sie die Zahlen verschiedener Prompts daher nicht.
- Unter 10 Suchanfragen pro Monat steht
null.volumeReasonnennt den Grund:not_searched(niemand sucht nach der Bedingung),part_not_searched(eine ihrer Bedingungen wird nicht gesucht) oderestimate_below_floor(die Schätzung liegt unter 10). Optionen auscores[].questionsbleiben im Ergebnis, auch wenn niemand nach ihnen sucht; eine Recherche zu einem Produkt für Unternehmen liefert daher oft vielenull-Prompts. - Die Zahlen sind Suchnachfrage. Sie zählen die Suchanfragen nach dem Bedarf hinter jedem Prompt im Markt über
demandSource.period.
Fehler und Abrechnung
Ein abgeschlossener Task kostet 14 Credits. Ein fehlgeschlagener Task wird nicht berechnet. Siehe Credits und Limits.Beim Einreichen abgelehnt
Fehlgeschlagene Tasks
Ein fehlgeschlagener Task hatstatus: "FAILED" und einen error-String, der mit seinem Code beginnt:
Nächste Schritte
GEO-Monitore
Verfolgen Sie die gefundenen Prompts planmäßig über KI-Engines hinweg.