Prompt Research

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" }'

​

Payload

​

Ergebnis

{
  "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

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

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

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" }'

​

topics[] und personas[]

​

brands[]

​

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.