brand-monitoring/
mentions

查找提到某个品牌、产品或话题的网页,逐页返回提及段落、作者、日期、站点类型、情感与情绪分数,以及权威度排名。

Brand Mentions API

全网提及
逐段情感分数
按站点类型筛选
权威度与垃圾分
每次请求 10 积分 + 每条结果 0.02 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Brand Mentions

品牌提及指的是公开网络上正文里出现了这个品牌的网页,比如测评、新闻、论坛帖子或商品页,连同品牌名前后的段落、作者、语言、国家和发布日期。给这些提及打上情感和情绪分数、再按网页和域名权威度排序,就能看出品牌在哪里被讨论、舆论偏向哪边、哪些来源分量更重,用于口碑监测、公关报道追踪和竞品研究。

Brand Mentions API 主要特性

  • 关键词或精确词组匹配query 可填最多 100 个字符的品牌、产品或话题,给词组加上英文双引号即按整个词组精确匹配。
  • 按站点类型筛选content_type 可限定为 news、blogs、message-boards、ecommerce 或 organization 类站点,每个结果的 page_types 也会注明站点类型。
  • 每段文字的情感与情绪sentiment 给出正面、负面、中性三个分数,合计为 1;emotions 从 0 到 1 分别给出快乐、喜爱、趣味、分享、悲伤、愤怒六种情绪的分数。
  • 权威度与质量信号domain_rank 和 page_rank 从 0 到 1000 衡量权威度,spam_score 和 content_quality_score 帮你排除内容单薄或带垃圾特征的网页。
  • 每条提及的上下文title、text 中的提及段落、author_name、language、country、有发布日期时的 published_at 以及 fetched_at,交代清楚每条提及出自何时何地。
  • 单次最多 1,000 个网页results_limit 可填 1 到 1000,一次就能盘点一个品牌在网上的露出。

Brand Mentions API 参数

参数必填描述
query必填要查找的品牌、产品或话题,最多 100 个字符;用英文双引号包住词组可精确匹配。
content_type可选提及所在的站点类型:news、blogs、message-boards、ecommerce 或 organization。
results_limit可选返回的网页数量,可填 1 到 1000,默认 100。

如何使用 Brand Mentions API

提交一个品牌或产品名,每行读取一条提及。

  1. 向 /v1/brand-monitoring/mentions 发送 {"query": "notion", "results_limit": 100}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取网页;has_more 为 true 时,用 results.next_cursor 请求下一页。
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}'

Brand Mentions API 最佳使用场景

  • 口碑监测: 把 sentiment.negative 高于正面分数的段落挑出来,结合网页的 domain_rank 优先处理。
  • 媒体报道追踪: 把 content_type 设为 news,保留 author_name、published_at 和 domain_rank,记录一次发布被哪些媒体报道、影响力如何。
  • 品牌声量对比: 用同样的请求分别查自家和竞品,对比提及在站点类型、国家和情感上的分布。
  • 收集论坛和社区讨论: 把 content_type 限定为 message-boards,收集用户用自己的话讨论产品的帖子。

Brand Mentions API 使用建议

  • 多词品牌名用英文双引号包住,例如 "notion ai",即可按完整短语匹配。
  • 有 published_at 时按它排序,没有时退回用 fetched_at 判断新旧,很多网页本身不标发布日期。
  • 统计情感之前,先去掉 spam_score 偏高或 content_quality_score 偏低的行,避免单薄网页拉偏结论。
  • 既要逐页明细又要整体比例时,搭配 Brand Sentiment Analysis API 一起使用。

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

  • Brand Sentiment Analysis API — 用一行数据汇总全网如何谈论某个品牌或话题,按情感和情绪给出网页数,以及每组背后的主要域名、国家和语言。

探索其他平台

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

Brand Mentions API — 常见问题

Brand Mentions API 是一个查找全网提到某个品牌、产品或话题的网页的 API,逐页返回提及段落、作者、日期、站点类型、情感与情绪分数,以及权威度和垃圾分。

正文与查询词匹配的已收录网页都算,涵盖新闻、博客测评、论坛帖子、电商商品页和企业网站;content_type 可以只保留其中一类。

针对提及处前后的段落打分:sentiment 给出正面、负面、中性三个合计为 1 的比例,emotions 给出六种情绪各自 0 到 1 的分数。

可以,在 query 里用英文双引号包住名称即可按词组精确匹配。

每次请求计 10 积分,每返回一个网页再加 0.02 积分;没有找到网页时同样收取 10 积分。