更新日志新功能

推出 Prompt Research

Prompt Research
无线耳机的提示词研究：覆盖 84.1% 搜索需求的 20 个提示词，按月搜索量排序

Prompt Research 把一个主题变成人们真正会问 AI 助手的问题，并按每个需求的月搜索量从高到低排序。

获得的结果

  • prompts：最多 50 个按向 AI 助手提问的方式写成的问题，按需求从高到低排列，每个问题都带有月搜索量和在整个主题需求中的占比。
  • 每个问题都标注了主题、用户画像、意图和购买阶段，方便按细分领域和购买阶段归类。
  • monitorSet：GEO 监测应跟踪的问题，按添加顺序排列。
  • brands：在同一领域吸引搜索需求的竞争品牌。

工作原理

发送一个种子主题（例如“防晒霜”）和一个市场，Prompt Research 会测量该市场围绕这个主题的月搜索需求（KR 取过去 30 天，US 取过去 12 个月的月均值），找出人们搜索最多的需求，并把每一个改写成人们会向 AI 助手提出的问题。KR 返回韩语问题，US 返回英语问题，大多数任务在 30 到 60 秒内完成。

同时发送品牌名称和品牌简介，每个问题都会获得适配度（fit）。包含品牌名称的问题会从结果中移除，因此用这些问题建立的监测衡量的是品牌凭自身获得的提及。

Playground 的提示词研究标签页和新建监测页面也会运行同样的研究。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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 到 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 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

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

价格

每个完成的研究任务消耗 12 个积分。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅