更新日志新功能

用品类监测追踪整个市场

Monitors
按被回答提及的比例为笔记本电脑品牌排名的品类报告

品类监测任务为 AI 引擎在一个市场中提到的品牌排名，并给出声量份额和每日趋势。

获得的结果

  • 回答提到的所有被跟踪品牌的排名，包含名次、提及率、声量份额以及与上一周期相比的变化。
  • 每个细分领域和每个引擎中被提及最多的 3 个品牌，看清每个品牌的优势所在。
  • 前 5 个品牌的每日提及率，以及每个提示词和引擎对应的单元格，可直接打开背后的回答。

工作原理

品牌监测跟踪一个品牌，品类监测跟踪一个市场：你为品类命名，把提示词按细分领域分组，每次运行都会向引擎提出这些提示词，并记录每条回答提到了哪些品牌。创建时把 mode 设为 CATEGORY，类型在监测任务的整个生命周期内保持固定。

  • category：买家对这个市场的叫法，1 到 80 个字符。
  • promptTopics：把每个提示词对应到细分领域，最多 30 个细分领域，名称最长 60 个字符。映射之外的提示词覆盖整个品类。
  • competitors：你列出的品牌最多 25 个。首次运行后，每周读取回答，再加入最多 25 个被提到的品牌。

GET /v1/monitors/{id}/analytics 返回报告。category.brands 中的声量份额等于 100 × 品牌提及次数 ÷ 所有被跟踪品牌的提及总数，因此同一周期的份额加起来为 100。品牌的提及率除以它自己的 sampleSize，即品牌在列表中期间评分的回答数，所以今天加入的品牌从今天开始计量。

应用场景

  • 了解哪些品牌在你所在市场的 AI 回答中领先，以及领先多少。
  • 看清每个竞争对手在哪些细分领域和引擎上占优。
  • 每周向客户或管理层汇报品类声量份额。

开始使用

在控制台中新建监测任务，把监测类型选为品类。输入主题并点击“运行研究”，Prompt Research 会根据 KR 或 US 的搜索需求填好提示词、细分领域和参与排名的品牌，你可以在创建前全部检查一遍。

发送请求

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

curl -X POST https://api.querying.ai/v1/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

请求字段

namestring必填
监测任务的名称。
modestring必填
BRAND（默认）跟踪你的品牌，CATEGORY 为市场中的所有品牌排名。
categorystring必填
市场名称，1 到 80 个字符。
enginesarray必填
要提问的引擎，最多 12 个，例如 CHATGPT、GEMINI、PERPLEXITY 和 GOOGLE。
promptsarray必填
每次运行提出的 1 到 100 个问题，按买家的提问方式书写。
promptTopicsobject
为每个提示词指定细分领域，例如 Kids。报告会按细分领域为品牌排名。
competitorsarray
一开始就参与排名的品牌，最多 25 个。每周分析会从回答中再补充最多 25 个。
countrystring
引擎作答所针对的市场。默认 US。
intervalHoursinteger
运行间隔（小时），1 到 168：1 每小时，24 每天，168 每周。

响应

响应如下，已截取部分内容。

JSON
{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}
data.monitor.idstring
监测任务的 ID，用于读取报告、评分结果和每条回答。
data.monitor.nextRunAtstring
下一次运行的时间。创建监测任务时立即开始第一次运行，之后每隔 intervalHours 运行一次。

读取报告

GET /v1/monitors/{id}/analytics 返回最近 30 天的报告。以下数字来自公开的跑鞋报告，已截取部分内容。

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
JSON
{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}
category.brandsarray
列表中的品牌以及回答提到的其他所有品牌，按被提及的回答数从多到少排列，附带 rank、mentionRate 和 shareOfVoice。
category.topicsarray
各细分领域的同类排名，按监测任务提问的顺序排列。

导出回答

GET /v1/monitors/{id}/results 为每条回答返回一行，回答提到的品牌放在 competitorHits 中。加上 format=csv，即可得到任何表格软件都能打开的文件：

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results?format=csv" \
  -H "Authorization: Bearer $QUERYING_API_KEY"
CSV
ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

价格

运行费用与品牌监测相同：每个提示词在每个引擎上运行一个任务，按各引擎的积分价格计费。寻找市场品牌每月另计 100 个积分，分摊到各次运行；用于填写表单的研究消耗 12 个积分。

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅