brand-monitoring/
sentiment

一次请求汇总网上怎么谈论一个品牌:按正面、负面、中性和情绪给网页分组,每组附网页数量,以及贡献最多的网站和国家。

Brand Sentiment Analysis API

正面、负面、中性
六种情绪
每组主要网站
国家与语言分布
每次请求 10 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Brand Sentiment Analysis

品牌情感是提到某个品牌的网页整体呈现的基调:多少网页偏正面、偏负面或中性,表达最多的又是快乐、喜爱还是悲伤、愤怒。再按每组背后的网站、国家、语言和站点类型拆开,就能分辨批评是来自新闻媒体、论坛还是某个市场,用于口碑汇报、营销活动复盘和竞品对标。

Brand Sentiment Analysis API 主要特性

  • 三组情感倾向sentiments 给出正面、负面、中性三组,每组的 mentions_count 是归入该组的网页数量。
  • 六组情绪emotions 把同一批网页按最强烈的情绪分组:快乐、喜爱、趣味、分享、悲伤和愤怒。
  • 每组背后的网站top_domains 列出该组网页最多的至多十个网站,看清正面或负面声量主要由谁带动。
  • 国家、语言与站点类型countries、languages 和 page_types 说明每组网页来自哪里,WW 表示面向全球的网站,站点类型包括 news、blogs、message-boards 等。
  • 每个品牌一行一次请求返回该查询的完整拆解,可以直接作为带日期的快照存档。

Brand Sentiment Analysis API 参数

参数必填描述
query必填要分析的品牌、产品或话题,最多 100 个字符;用英文双引号包住词组可精确匹配。

如何使用 Brand Sentiment Analysis API

提交一个品牌或话题,以单行结果读取情感拆解。

  1. 向 /v1/brand-monitoring/sentiment 发送 {"query": "notion"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded;宽泛的热门词可能需要几分钟。
  3. 从 results.items 读取拆解结果;has_more 和 results.next_cursor 遵循通用分页规则,单行结果下为空。
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"}'

Brand Sentiment Analysis API 最佳使用场景

  • 按月存档口碑快照: 每月记录各情感组的 mentions_count,画出负面网页占比随时间的变化。
  • 追查批评的来源: 看负面组的 top_domains、countries 和 page_types,判断差评集中在少数网站、某个国家还是论坛。
  • 与竞品对标: 用同样的查询方式分别分析自家和竞品,比较正面、负面、中性数量和主导情绪。
  • 复盘营销活动: 对比活动前后快乐、愤怒等情绪组的变化,看讨论风向怎么转变。

Brand Sentiment Analysis API 使用建议

  • 尽量分析具体的产品名或活动名,而不是泛泛的通用词;提及量上百万的宽泛词可能要几分钟才能完成。
  • 竞品查询和自家查询放在同一天跑,几份快照反映的才是同一时刻的网络状况。
  • 某一组数字变化明显时,用同样的 query 调用 Brand Mentions API,读一读背后的具体网页。

除了 Brand Sentiment Analysis API,需要其他类型的 Brand Monitoring 公开数据时,可以使用以下 API。

  • Brand Mentions API — 查找提及某个品牌、产品或话题的网页,返回相关段落、作者、日期、站点类型、情感与情绪评分,以及页面和域名权威度。

探索其他平台

还可以将 Brand Monitoring 数据与其他已支持社交平台的公开数据结合使用。

Brand Sentiment Analysis API — 常见问题

Brand Sentiment Analysis API 是一个汇总全网提到某个品牌、产品或话题的网页情感基调的 API,返回正面、负面、中性三组和六种情绪组的网页数量,以及每组的主要网站、国家、语言和站点类型。

Brand Mentions API 逐页列出网页及各自的分数;Brand Sentiment Analysis API 只返回一行汇总,把所有匹配的网页按情感和情绪分组。

快乐、喜爱、趣味、分享、悲伤和愤怒,每种情绪单独成组,附网页数量和来源分布。

大多数查询不到一分钟就能完成;匹配网页上百万的宽泛词可能需要几分钟。

每次请求计 10 积分,返回一行。