品牌监测品牌提及情感分析舆情API 指南

品牌监测 API:带情感、情绪与权威度评分的全网提及

SocQ 新增两个接口:采集提到某品牌的网页,附情感、情绪和权威度评分;并把全部提及按正面、负面和中性拆分。

SocQ更新于 2026年11月19日阅读约 5 分钟

品牌监测通常从两个问题开始:网上哪里在谈论我们?大家对我们是什么态度?第一个问题需要可以阅读和分派的网页级数据;第二个问题需要一个不必下载数百万网页就能画成图表的汇总。

SocQ 于 2026-11-17 上线了 Brand Monitoring 平台,每个问题对应一个接口。本文介绍它们返回什么、怎么请求、价格多少,以及各自适合的场景。

快速回答: 把品牌、产品或话题放进 query,发送到 POST /v1/brand-monitoring/mentions,获取提到它的网页列表,每个网页带情感、情绪和权威度评分。把同样的 query 发送到 POST /v1/brand-monitoring/sentiment,获取一行按情感和情绪拆分全部提及的汇总。轮询 GET /v1/tasks/{task_id} 读取结果。

新上线的品牌监测接口

1 SocQ 积分 = $0.005。

接口返回内容价格
Brand Mentions API(品牌提及)每个提到查询词的网页一行:URL、标题、提及处的段落、作者、语言、国家、站点类型、情感和情绪评分,以及页面和域名权威度每次请求 10 积分($0.05)+ 每个网页 0.02 积分($0.0001)
Brand Sentiment Analysis API(品牌情感分析)一行汇总:把提到查询词的全部网页按主要情感和最强情绪分组,给出每组的网页数,以及贡献最多的站点、国家、语言和站点类型每次调用 10 积分($0.05)

Brand Mentions 在没有找到网页时,同样收取 10 积分基础费用。

鉴权与异步任务流程

所有 SocQ 请求都使用 API Key 鉴权,提交、任务状态和结果请求使用同一个请求头:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次采集都作为后台任务运行:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

提交响应中包含 data.task_id 和 data.status。用这个 ID 轮询任务:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

当 status 为 succeeded 时,响应会在 data.results.items 中带上第一页标准化结果。limit 默认 50,最大 500;如果 has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。任务处于 queued、running 或 failed 时,接口只返回任务元数据,不含 results。

在提交请求体中加入可选的 callback_url,任务结束后 SocQ 会发送一次带任务摘要的 POST;结果记录仍通过 GET /v1/tasks/{task_id} 读取。客户端超时不会取消任务,请用同一个任务 ID 继续查询,而不是重新提交并重复付费。402 表示积分不足;429 表示 API Key 触发了频率或积分限制。

Brand Mentions API:每一个提到你的网页

Brand Mentions API 返回全网提到查询词的网页:博客评测、新闻报道、论坛帖子和商品页。通过 query 提供品牌、产品或话题,最多 100 个字符。用双引号包住短语即可精确匹配。content_type 可以把结果限定为 news、blogs、message-boards、ecommerce 或 organization 类站点。results_limit 默认 100,可填 1 到 1,000。

curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "notion",
    "results_limit": 100
  }'

每行描述一个网页:

  • 在哪里: url、title、domain、language、country(两位字母代码,WW 表示全球)和 page_types,例如 news、blogs 或 ecommerce。
  • 说了什么: text,即提及处的段落;有作者时给出 author_name。
  • 态度如何: sentiment 含 positive、negative 和 neutral 三个 0 到 1 的分数,三者相加为 1;emotions 含六个 0 到 1 的分数:happiness、love、fun、share、sadness 和 anger。
  • 分量多大: content_quality_score(0 到 100)、spam_score(0 到 100,越高垃圾特征越多)、domain_rank 和 page_rank(0 到 1,000)。
  • 何时: fetched_at,网页最近一次被读取的时间。

权威度和垃圾评分可以给大量结果排序,让团队先看高权威、低垃圾的网页;情感拆分则能标出需要回应的网页。100 个网页计 12 积分($0.06),上限 1,000 个网页计 30 积分($0.15)。完整字段见 品牌提及文档。

只看媒体报道时,加上过滤条件:

{
  "query": "\"notion ai\"",
  "content_type": "news",
  "results_limit": 200
}

Brand Sentiment Analysis API:数字背后的拆分

Brand Sentiment Analysis API 不返回单个网页,而是回答“网上对我们是什么态度”。提到查询词的网页按主要情感分组,并另外按最强情绪分组。每组给出包含的网页数,以及贡献最多的站点、国家、语言和站点类型。

curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "notion"
  }'

唯一的结果行包含两个数组:

  • sentiments:positive、negative 和 neutral 各一组。
  • emotions:happiness、love、fun、share、sadness 和 anger 各一组。

每组都有 label、mentions_count,以及 top_domains、countries、languages 和 page_types,每项都是按数量从大到小排列的 name 与 count 列表。借助这个结构,你可以判断批评来自新闻媒体还是某一个论坛,以及由哪些国家主导。每次请求 10 积分($0.05)。提及量达到数百万的宽泛词分析时间更长,可能需要几分钟,请耐心轮询。见 品牌情感分析文档。

该用哪个接口

  • 每周舆情看板: 对你的品牌和每个竞品各跑一次 Brand Sentiment Analysis,保存数量并按时间画图。四个品牌每次共 40 积分($0.20)。
  • 公关团队的处理队列: 运行 Brand Mentions,把 content_type 设为 news 或 message-boards,再按 negative 情感分数和 domain_rank 排序。
  • 排查舆情突增: 情感数量出现波动时,查看负面组的 top_domains 找出主要来源站点,再用 Brand Mentions 拉取这些网页。

两个接口处理的都是上述五类站点的网页。社交网络上的帖子和评论请使用各平台接口,详见 统一社交媒体 API 指南。想了解 AI 助手如何谈论你的品牌,请看 AI 搜索 API 指南。

常见问题

什么是品牌监测 API?

一种找出品牌、产品或话题在哪里被提及、以及这些提及态度如何的 API。SocQ 的版本返回带情感、情绪和权威度评分的网页级提及,以及按情感和情绪汇总的拆分。

如何精确匹配一个短语?

在 query 中用双引号把短语包起来,例如 JSON 中写作 "\"notion ai\""。查询词最多 100 个字符。

覆盖哪些类型的站点?

网页分为 news、blogs、message-boards、ecommerce 和 organization 五类。Brand Mentions 可以通过 content_type 限定为其中一类。

什么都没找到也收费吗?

Brand Mentions 在没有找到网页时也收取 10 积分基础费用,另按每个返回的网页加 0.02 积分。Brand Sentiment Analysis 每次请求 10 积分。

为什么我的情感分析任务还在运行?

提及量达到数百万的宽泛词分析时间更长,可能需要几分钟。请继续轮询同一个 task_id,不要重新提交。

BRAND MONITORING API

使用公开的 Brand Monitoring 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Brand Monitoring API