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
提交一个品牌或话题,以单行结果读取情感拆解。
- 向 /v1/brand-monitoring/sentiment 发送 {"query": "notion"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded;宽泛的热门词可能需要几分钟。
- 从 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,读一读背后的具体网页。
相关 API
除了 Brand Sentiment Analysis API,需要其他类型的 Brand Monitoring 公开数据时,可以使用以下 API。
- Brand Mentions API — 查找提及某个品牌、产品或话题的网页,返回相关段落、作者、日期、站点类型、情感与情绪评分,以及页面和域名权威度。