更新情報新機能

Prompt Researchを紹介します

Prompt Research
ワイヤレスイヤホンのプロンプトリサーチ。検索需要の84.1%をカバーする20件のプロンプトを月間検索数順に表示

Prompt Researchは1つのトピックを、人々がAIアシスタントに実際に尋ねる質問に変え、そのニーズの月間検索需要が大きい順に並べます。

得られる結果

  • prompts: AIアシスタントへの問いかけの形で書かれた質問を最大50件。需要の大きい順に並び、質問ごとに月間検索数とトピック全体の需要に占める割合が付きます。
  • 質問ごとにトピック、ペルソナ、意図、購買段階が付くため、サブ分野や購買段階ごとにまとめて見られます。
  • monitorSet: GEOモニターで追跡する質問を、追加する順に並べたセットです。
  • brands: 同じ分野で検索需要を集めている競合ブランドです。

仕組み

「日焼け止め」のようなシードトピックと市場を送ると、Prompt Researchがその市場でトピックへ集まる月間検索需要を測ります。KRは直近30日、USは直近12か月の月平均です。最も多く検索されているニーズを見つけ、人がAIアシスタントに投げかける質問の形に書き直します。KRは韓国語、USは英語の質問を返し、ほとんどの実行は30〜60秒で完了します。

ブランド名とブランドの説明を送ると、質問ごとに適合度（fit）が付きます。ブランド名を含む質問は結果から外れるため、この質問で作ったモニターはブランドが自力で獲得した言及を測れます。

Playgroundのプロンプトリサーチタブと新規モニター画面も同じリサーチを実行します。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

curl -X POST https://api.querying.ai/v1/prompt-research \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "seed": "wireless earbuds", "country": "US", "limit": 20 }'

リクエストのフィールド

seedstring必須
トピック。文字、数字、半角スペース1つで1〜30文字。例: sunscreen。
countrystring必須
KR または US。プロンプトはその市場の言語で返ります。
limitinteger
返すプロンプト数。1〜50、既定値は20。
excludearray
最大20語。いずれかを含むプロンプトは結果から外れます。
monitorSizeinteger
monitorSet に入れるプロンプト数。1〜50、既定値は20。
monitorEnginesarray
モニターで実行するエンジン。monitorSize がモニターの上限であるプロンプト × エンジン200件に収まるよう確認します。
brandstring
自社ブランド。ブランド名を含むプロンプトは結果から外れるため、すべてのプロンプトが実際の需要を測ります。
brandDescriptionstring
ブランドが何を誰に売っているかを最大500文字で。各プロンプトに fit が付き、自社が答えられるプロンプトが優先されます。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "ba954bab-33ec-4bb0-b175-a9b85258a4ac",
    "taskType": "PROMPT_RESEARCH",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:55:29.285Z"
  },
  "credits": { "creditsToCharge": 12, "creditsCharged": 12 },
  "response": {
    "seed": "wireless earbuds",
    "country": "US",
    "language": "en",
    "seedMonthlySearchVolume": 165000,
    "promptsFound": 28,
    "prompts": [
      {
        "prompt": "Which noise-cancelling earbuds should I choose?",
        "topic": "Earbud features",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 118380,
        "demandShare": 0.2585
      },
      {
        "prompt": "What are the best wireless earbuds to buy?",
        "topic": "Choosing earbuds",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 78840,
        "demandShare": 0.1722
      }
    ],
    "monitorSet": {
      "prompts": [
        {
          "rank": 1,
          "prompt": "Which noise-cancelling earbuds should I choose?",
          "topic": "Earbud features",
          "persona": null,
          "intent": "commercial",
          "funnelStage": "consideration",
          "brandMentions": "likely",
          "monthlySearchVolume": 118380,
          "demandShare": 0.2585
        }
      ],
      "coverage": {
        "demandShare": 0.8406,
        "topics": { "total": 5, "covered": 5 },
        "personas": { "total": 9, "covered": 8 }
      }
    },
    "topics": [
      {
        "topic": "Choosing earbuds",
        "monthlySearchVolume": 191440,
        "promptCount": 9,
        "demandShare": 0.4181
      },
      {
        "topic": "Earbud features",
        "monthlySearchVolume": 161940,
        "promptCount": 6,
        "demandShare": 0.3537
      }
    ],
    "personas": [
      {
        "persona": "people who sleep with earbuds",
        "monthlySearchVolume": 17700,
        "promptCount": 1,
        "demandShare": 0.0387
      }
    ],
    "brands": [
      { "brand": "Beats", "monthlySearchVolume": 560980 },
      { "brand": "Apple", "monthlySearchVolume": 509920 },
      { "brand": "Samsung", "monthlySearchVolume": 91750 }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.promptsarray
人々が AI アシスタントに尋ねる質問を需要の大きい順に。topic、persona、intent、funnelStage、monthlySearchVolume、demandShare が付きます。
response.monitorSetobject
モニターで追うべきプロンプトを追加する順に。需要、トピック、ペルソナの coverage も付きます。
response.topicsarray
サブトピック別に合計した需要。monthlySearchVolume、demandShare、promptCount。personas は同じ集計を対象者別に行います。
response.brandsarray
この分野で人々が検索するブランドと月間検索数。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

料金

完了したリサーチタスク1件につき12クレジットを使用します。

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード