> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Prompt Research > Die Fragen, die Menschen KI-Assistenten zu einem Thema stellen, sortiert nach der monatlichen Suchnachfrage dahinter Senden Sie ein Thema und erhalten Sie die Fragen, die Menschen einem KI-Assistenten dazu stellen würden, sortiert danach, wie viele Menschen jeden Monat nach diesem Bedarf suchen, dazu die Auswahl daraus, die ein [GEO-Monitor](/de/monitors) verfolgen sollte, in der Reihenfolge, in der Sie sie hinzufügen. Nutzen Sie das, um die Prompts eines Monitors auszuwählen und um zu sehen, welche konkurrierenden Marken im selben Bereich Nachfrage auf sich ziehen. ```bash theme={null} curl -X POST https://api.querying.ai/v1/prompt-research \ -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \ -d '{ "seed": "선크림", "country": "KR", "limit": 20, "brand": "MyBrand" }' ``` Der Aufruf gibt einen eingereihten Task zurück. Fragen Sie `GET /v1/async/task/:id` ab oder geben Sie beim Einreichen `webhook.url` an; der Task meldet `taskType: "PROMPT_RESEARCH"` und ist meist nach 30–60 Sekunden fertig. Reichen Sie ihn nicht über `POST /v1/async/task` ein, sondern nutzen Sie diesen Endpoint. ## Payload | Feld | Pflicht | Hinweise | | - | - | - | | `seed` | ja | Das Thema: 1–30 Zeichen aus Buchstaben, Ziffern und einzelnen Leerzeichen, etwa `선크림` oder `무선청소기`. Ein kurzer Produkt- oder Kategoriebegriff funktioniert am besten; ein ganzer Satz findet nichts. | | `country` | ja | `KR` (Südkorea) oder `US` (USA). Jeder andere Wert wird mit `422 REGION_UNSUPPORTED` abgelehnt. Prompts sind in der Sprache des Marktes: Koreanisch für `KR`, Englisch für `US`. | | `limit` | nein | Anzahl der zurückgegebenen Prompts, 1–50. Standard 20. | | `exclude[]` | nein | Bis zu 20 Begriffe mit 1–30 Zeichen. Ein Prompt, der einen davon enthält, wird ausgelassen. Nutzen Sie das für ein Unterthema, das Sie nicht brauchen; Ihre eigene Marke gehört in `brand`. | | `monitorSize` | nein | Anzahl der Prompts in `monitorSet`, 1–50. Standard 20. | | `monitorEngines[]` | nein | Die Engines, die Ihr Monitor ausführen wird, bis zu 12, benannt wie bei den [Monitoren](/de/monitors): `CHATGPT`, `GEMINI`, `PERPLEXITY`, `GOOGLE`, `AIMODE`, `NAVER_AI_BRIEF`, `NAVER_AI_TAB`. Ein Monitor führt höchstens 200 Prompt × Engine-Tasks auf einmal aus; übersteigt `monitorSize` × die Anzahl der Engines 200, wird die Anfrage mit `422 VALIDATION_ERROR` für `monitorSize` abgelehnt. Das Ergebnis ändert sich dadurch nicht. | | `brand` | nein | Ihre Marke: 1–80 Zeichen mit mindestens zwei Buchstaben oder Ziffern; Satzzeichen sind erlaubt. Prompts, die sie enthalten, werden wie bei `exclude` ausgelassen. | | `brandAliases[]` | nein | Bis zu 10 weitere Namen oder Schreibweisen Ihrer Marke, die ebenso ausgelassen werden. Erfordert `brand`. | | `brandDescription` | nein | Bis zu 500 Zeichen dazu, was Ihre Marke an wen verkauft. Erfordert `brand`. Jeder Prompt erhält dann ein `fit`, und `monitorSet` bevorzugt die Prompts, die Ihre Marke beantwortet. | | `idempotencyKey`, `webhook` | nein | Wie bei [`POST /v1/async/task`](/de/api-reference/create-task). | ## Ergebnis Aus einem Lauf für 선크림, auf wenige Einträge gekürzt: ```json theme={null} { "seed": "선크림", "country": "KR", "language": "ko", "demandSource": { "period": "last_30_days", "fetchedAt": "2026-09-29T05:23:52.548Z" }, "seedMonthlySearchVolume": 24470, "promptsFound": 96, "prompts": [ { "prompt": "선스틱은 어떤 제품을 고르면 좋아?", "topic": "선스틱", "persona": null, "intent": "commercial", "funnelStage": "consideration", "brandMentions": "likely", "monthlySearchVolume": 14670, "demandShare": 0.1334 }, { "prompt": "톤업 선크림은 어떤 제품이 좋아?", "topic": "톤업과 메이크업", "persona": null, "intent": "commercial", "funnelStage": "consideration", "brandMentions": "likely", "monthlySearchVolume": 13500, "demandShare": 0.1227 } ], "monitorSet": { "prompts": [ { "rank": 1, "prompt": "선스틱은 어떤 제품을 고르면 좋아?", "topic": "선스틱", "persona": null, "intent": "commercial", "funnelStage": "consideration", "brandMentions": "likely", "monthlySearchVolume": 14670, "demandShare": 0.1334 }, { "rank": 5, "prompt": "블루라이트 차단 선크림은 효과가 있어?", "topic": "성분과 차단 방식", "persona": null, "intent": "informational", "funnelStage": "awareness", "brandMentions": "sometimes", "monthlySearchVolume": 1240, "demandShare": 0.0113 } ], "coverage": { "demandShare": 0.8278, "topics": { "covered": 13, "total": 20 }, "personas": { "covered": 4, "total": 19 } } }, "topics": [ { "topic": "선크림 추천", "monthlySearchVolume": 21930, "promptCount": 12, "demandShare": 0.1994 }, { "topic": "성분과 차단 방식", "monthlySearchVolume": 19880, "promptCount": 15, "demandShare": 0.1807 } ], "personas": [ { "persona": "남성", "monthlySearchVolume": 6420, "promptCount": 2, "demandShare": 0.0584 } ], "brands": [ { "brand": "시세이도", "monthlySearchVolume": 3410 } ] } ``` ### `prompts[]`, höchste Nachfrage zuerst * `prompt` — die Frage in der Sprache des Marktes, so wie ein Mensch sie einem KI-Assistenten stellen würde. Sie nennt nie eine Marke: Ein Prompt, der eine Marke nennt, fände diese Marke in jeder Antwort. * `topic` — das übergeordnete Unterthema des Bedarfs. Prompts eines Unterthemas teilen das Label; `topics[]` summiert sie. * `persona` — wer fragt, wenn die Suchanfragen eine Zielgruppe, einen Zustand oder eine Situation nennen (Männer, Eltern von Babys, fettige Haut); sonst `null`. * `intent` — `informational` (wie, was, warum), `commercial` (auswählen, vergleichen, empfehlen) oder `transactional` (Preis, wo kaufen). * `funnelStage` — `awareness` (Bedarf oder Kategorie kennenlernen), `consideration` (Optionen vergleichen), `purchase` (Preis, wo kaufen) oder `post_purchase` (das Gekaufte verwenden). * `brandMentions` — ob eine gute Antwort auf den Prompt Marken, Produkte oder Anbieter nennt: `likely` (sie empfiehlt, rankt oder vergleicht Optionen), `sometimes` (sie erklärt, meist mit Beispielprodukten) oder `rarely` (sie erklärt ein Konzept, eine Methode oder eine Anwendung ohne Produkte). * `fit` — nur wenn Sie `brandDescription` senden: `core` (laut Beschreibung bietet Ihre Marke, wonach der Prompt fragt), `related` (alles, was die Beschreibung nicht erwähnt) oder `none` (die Beschreibung schließt es aus, etwa eine andere Zielgruppe oder ein anderes Produkt). * `monthlySearchVolume` — monatliche Suchanfragen für den Bedarf hinter dem Prompt. * `demandShare` — der Anteil dieses Prompts an der Nachfrage aller gefundenen nutzbaren Prompts, von 0 bis 1. ### `monitorSet` Die Prompts, die ein Monitor verfolgen sollte, in der Reihenfolge, in der Sie sie hinzufügen, ausgewählt aus allen gefundenen verwendbaren Prompts, auch jenseits von `limit`. Die Auswahl bevorzugt Prompts, die viele Menschen stellen und deren Antworten einem Monitor etwas zu messen geben, verteilt über Themen und Personas. Jeder Eintrag hat die Felder eines `prompts[]`-Eintrags plus `rank`, beginnend bei 1. `coverage` zeigt, wie viel der Recherche die Auswahl abdeckt: * `demandShare` — Anteil der ausgewählten Prompts an den Suchanfragen hinter allen gefundenen verwendbaren Prompts, von 0 bis 1. * `topics`, `personas` — wie viele der gefundenen Themen und Personas die Auswahl abdeckt, als `covered` von `total`. So verhält sich die Auswahl: * Ein Prompt mit `fit` `none` wird nie gewählt; die Auswahl kann daher weniger als `monitorSize` Prompts enthalten. * `monitorSize` schneidet nur dieselbe Reihenfolge ab: Die ersten 12 Prompts einer 20er-Auswahl sind die 12er-Auswahl, sodass ein wachsender Monitor die Prompts behält, die er schon verfolgt. * Ein Monitor führt höchstens 200 Prompt × Engine-Tasks auf einmal aus. Senden Sie `monitorEngines` mit den Engines Ihres Monitors, dann wird ein `monitorSize`, der nicht passt, schon beim Einreichen abgelehnt: Bei fünf Engines ist `monitorSize` höchstens 40. Um Prompts zu bevorzugen, die Ihre Marke beantwortet, beschreiben Sie Ihre Marke: ```bash theme={null} curl -X POST https://api.querying.ai/v1/prompt-research \ -H "Authorization: Bearer $QUERYING_API_KEY" -H "Content-Type: application/json" \ -d '{ "seed": "선크림", "country": "KR", "monitorSize": 12, "monitorEngines": ["CHATGPT", "PERPLEXITY"], "brand": "MyBrand", "brandDescription": "Gentle mineral sunscreens for sensitive and dry skin" }' ``` Die Beschreibung wird so bewertet, wie sie geschrieben ist; bei einer einzigen Zeile bleiben die meisten Prompts `related`. Um ein Unterthema aus der Auswahl herauszuhalten, ist `exclude` zuverlässiger. ### `topics[]` und `personas[]` Die Nachfrage, summiert nach Thema und nach Persona über alle gefundenen nutzbaren Prompts, auch jenseits von `limit`, höchste zuerst. Jeder Eintrag hat `monthlySearchVolume`, `demandShare` und `promptCount`. Prompts ohne Persona fehlen in `personas[]`. ### `brands[]` Marken, Hersteller und Produktlinien, nach denen in diesem Bereich gesucht wird, mit ihren monatlichen Suchanfragen. Ihre Nachfrage fließt nicht in `prompts` ein, weil Prompts keine Marken nennen. ### Weitere Felder * `seedMonthlySearchVolume` — monatliche Suchanfragen für den `seed` selbst; `null`, wenn es dafür keinen Wert gibt. * `promptsFound` — brauchbare Prompts, bevor `limit` angewendet wurde. * `demandSource` — der Zeitraum, den die Zahlen abdecken, und `fetchedAt`. `KR`: `last_30_days`. `US`: `monthly_average_last_12_months`, daher liegt ein saisonaler Begriff auf seinem Höhepunkt unter den Suchanfragen dieses Monats. ## Das Ergebnis richtig lesen * **Suchnachfrage ist kein KI-Gesprächsvolumen.** Die Zahlen zählen monatliche Suchanfragen im jeweiligen Markt. Sie zeigen, wie viele Menschen nach einem Bedarf suchen; wie oft derselbe Bedarf KI-Assistenten gestellt wird, ist nirgends öffentlich erfasst. Nutzen Sie sie, um Prompts zu ordnen, nicht als Prognose für KI-Traffic. * **Der Wortlaut wird generiert, die Zahlen nicht.** Jeder Prompt wird für seinen Bedarf geschrieben, und derselbe `seed` kann in einem anderen Lauf anders gruppiert werden: Der Anfang der Liste ist meist stabil, das Ende variiert. * **Seltene Suchanfragen fallen weg.** Begriffe, die seltener als 10-mal im Monat gesucht werden, haben keine ausgewiesene Nachfrage und tragen nichts zu einem Prompt bei. * **Anteile vergleichen Bedarfe innerhalb eines Seeds.** `demandShare` zeigt, wie sich die Suchnachfrage rund um diesen Seed auf Bedarfe, Themen und Personas verteilt. Es ist kein Anteil an KI-Gesprächen, und Anteile verschiedener Seeds lassen sich nicht addieren. ## Fehler und Abrechnung * 12 Credits pro abgeschlossenem Task. Ein fehlgeschlagener Task gibt seine Credit-Reservierung frei. * `422 VALIDATION_ERROR` — ein Feld liegt außerhalb des zulässigen Bereichs, `brandAliases` bzw. `brandDescription` wurde ohne `brand` gesendet, oder `monitorSize` × die Anzahl der `monitorEngines` übersteigt 200. * `422 REGION_UNSUPPORTED` — `country` ist weder `KR` noch `US`. * Das `error` einer fehlgeschlagenen Aufgabe beginnt mit ihrem Code. `NO_SEARCH_DEMAND` bedeutet, dass für den `seed` und alles Verwandte keine Suchnachfrage gefunden wurde; versuchen Sie einen breiteren oder gängigeren Begriff. `NO_RELATED_SEARCHES` bedeutet, dass der `seed` selbst gesucht wird, aber nichts Verwandtes; versuchen Sie eine spezifischere Formulierung, nach der Menschen suchen. Derselbe `seed` scheitert erneut auf dieselbe Weise. `KEYWORD_DATA_UNAVAILABLE`, `ANALYSIS_FAILED` und `ANALYSIS_TIMEOUT` sind vorübergehend; versuchen Sie es kurz darauf erneut.