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
提交一个品牌或产品名,每行读取一条提及。
- 向 /v1/brand-monitoring/mentions 发送 {"query": "notion", "results_limit": 100}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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 一起使用。
相关 API
除了 Brand Mentions API,需要其他类型的 Brand Monitoring 公开数据时,可以使用以下 API。
- Brand Sentiment Analysis API — 用一行数据汇总全网如何谈论某个品牌或话题,按情感和情绪给出网页数,以及每组背后的主要域名、国家和语言。