Zum Hauptinhalt springen
Prompt Research findet die besten Prompts, die Käufer zu einem Thema an KI-Assistenten senden. Senden Sie ein Thema, und das Ergebnis listet zuerst die einfache Anfrage für jede Produktart, dann dieselbe Anfrage mit den Bedingungen, die Käufer hinzufügen, etwa ein Budget, ein Hauttyp oder eine Branche. Jeder Prompt trägt die monatlichen Suchanfragen dahinter, 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

  1. Produktarten. Die Keyword-Daten des Markts zeigen, nach welchen Produktarten Menschen unter dem Thema suchen, etwa sunscreen stick unter sunscreen. Das sind die cores[] im Ergebnis.
  2. 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[].questions im Ergebnis. Ihre Optionen werden zu Bedingungen, zusammen mit den Varianten, nach denen Menschen suchen (tinted sunscreen, sunscreen for oily skin).
  3. Prompts. Die Bedingungen werden bis zu depth zu Prompts kombiniert, jeder mit seinen gemessenen oder geschätzten Suchanfragen, in empfohlener Reihenfolge.
Eine Recherche dauert etwa 1 bis 3 Minuten.

Recherche-Task einreichen

Der Task wird angenommen und eingereiht:
Lesen Sie das Ergebnis mit 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

  • US schreibt 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.
  • KR schreibt 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

Ein sunscreen-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 Sie brand 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.
Eine Produktart oder Bedingung, die die Beschreibung ausschließt, etwa eine andere Zielgruppe oder ein anderes Produkt, wird ausgelassen; ein Ergebnis kann daher weniger Prompts als limit enthalten. fit stellt die Prompts, die Ihre Marke beantwortet, weiter nach vorn; die Nachfragezahlen bleiben gleich.
Die Prompts in einem solchen Ergebnis tragen fit zum Beispiel so:
Die Beschreibung wird so bewertet, wie sie geschrieben ist; bei einer einzigen Zeile bleiben die meisten Prompts 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 Sie prompts[] 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:
Die Liste steht in empfohlener Reihenfolge, daher ergeben die ersten N Prompts einen ausgewogenen Monitor mit N Prompts. Ein Lauf eines Monitors darf höchstens so viele Tasks einreihen, wie das Limit 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.
Ein neu erstellter Monitor startet seinen ersten Lauf sofort, und jeder Lauf wird wie die Tasks abgerechnet, die er einreiht. Prüfen Sie die Anzahl der Prompts und Engines, bevor Sie ihn erstellen.
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. volumeReason nennt den Grund: not_searched (niemand sucht nach der Bedingung), part_not_searched (eine ihrer Bedingungen wird nicht gesucht) oder estimate_below_floor (die Schätzung liegt unter 10). Optionen aus cores[].questions bleiben im Ergebnis, auch wenn niemand nach ihnen sucht; eine Recherche zu einem Produkt für Unternehmen liefert daher oft viele null-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

Authentifizierungs-, Credit- und Parallelitätsfehler sind dieselben wie bei jedem Task. Siehe Fehler.

Fehlgeschlagene Tasks

Ein fehlgeschlagener Task hat status: "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.