Brand Monitoring API
查找提及某个品牌、产品或话题的网页,为每个网页打出情感和情绪评分,并汇总全网如何谈论它。
可用的 Brand Monitoring API
用 Brand Mentions API 逐页查看带情感与权威度评分的提及,用 Brand Sentiment Analysis API 获取按情感和情绪分组的一行汇总。
可以获取哪些品牌监测数据?
两个 API 读取同一批已收录网页:一个返回网页本身,一个返回汇总。
网页上的提及
网页标题、URL、提及前后的段落、作者、域名、语言、国家以及发布或抓取日期。
情感与情绪
合计为 1 的正面、负面、中性占比,以及喜悦、喜爱、乐趣、分享、悲伤、愤怒的 0–1 评分。
权威度与质量
0–1000 的域名和页面排名,以及 0–100 的垃圾内容评分和内容质量评分。
站点类型
每个网页属于新闻、博客、论坛、电商页面还是机构网站。
情感分布
各情感组和情绪组的网页数,以及每组背后的主要域名、国家、语言和网页类型。
Brand Mentions 还是 Brand Sentiment Analysis
需要整体情况和背后的具体网页时,可以用同一个 query 同时调用两者。
| 对比项 | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| 结果 | 每个网页一行 | 每个 query 一行汇总 |
| 情感 | 每个网页段落的评分 | 各情感组和情绪组的网页数 |
| 来源 | 每个网页的域名、作者、站点类型和权威度 | 每组的主要域名、国家、语言和网页类型 |
| 筛选 | query、content_type,results_limit 最多 1,000 | query |
| 计费 | 每次请求 10 积分,另加每个网页 0.02 积分 | 每次请求 10 积分 |
Brand Monitoring API 如何工作
两个 API 使用相同的异步任务流程。
1. 提交 query
把品牌、产品或话题 POST 到 /v1/brand-monitoring/mentions 或 /v1/brand-monitoring/sentiment。
2. 跟踪任务
轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded;宽泛的词可能需要几分钟。
3. 读取结果
在 results.items 中读取网页列表或汇总行。
使用 SocQ API key 认证并提交品牌名称。每次请求消耗 10 积分,另按每返回一个网页加收 0.02 积分。
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.items常见 Brand Monitoring API 使用场景
口碑监测
找出高权威网页上的负面段落,优先处理。
媒体报道追踪
在发布或公告后收集新闻提及,记录作者、日期和域名排名。
竞品对标
比较自家品牌与竞品的情感、情绪和来源构成。
社区声音收集
汇集论坛中用户用自己的话描述产品的帖子。
活动复盘
比较活动前后的情感组和情绪组变化。
请求规则与计费
以下规则适用于两个 Brand Monitoring API。
- query 填写品牌、产品或话题,最多 100 个字符;用双引号包住短语可精确匹配。
- Brand Mentions API 的 content_type 可选 news、blogs、message-boards、ecommerce 或 organization,每次返回 1–1,000 个网页,默认 100 个。
- 大多数情感汇总在一分钟内完成;匹配网页达数百万的宽泛词可能需要几分钟。
- Brand Mentions API 每次请求 10 积分,另加每返回一个网页 0.02 积分;Brand Sentiment Analysis API 每次请求 10 积分。
Brand Monitoring API 常见问题
Brand Monitoring API 是什么?
Brand Monitoring API 查找提及某个品牌、产品或话题的网页并衡量其情感,可以用 Brand Mentions API 逐页查看,也可以用 Brand Sentiment Analysis API 获取一行汇总。
有哪些 Brand Monitoring API 可用?
返回单个网页及其情感、情绪和权威度评分的 Brand Mentions API,以及返回全部匹配网页情感与情绪分布的 Brand Sentiment Analysis API。
覆盖哪些网站?
已收录的公开网页,包括新闻文章、博客、论坛、电商页面和机构网站等。
情感是如何衡量的?
对每次提及前后的段落评估正面、负面、中性以及六种情绪;情感汇总按这些评分对网页分组。
Brand Monitoring 请求如何计费?
Brand Mentions API 每次请求 10 积分,另加每返回一个网页 0.02 积分;Brand Sentiment Analysis API 每次请求 10 积分。
结合多平台数据,获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。
AI Search API
追踪 AI 概览、ChatGPT 和 Google AI 模式如何回答你所在市场的问题:哪些回答点名了你的品牌、你的可见度有多高,以及它们引用了哪些域名和页面。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页,并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
TikTok API
通过统一异步流程采集受支持的 TikTok 公开资料、直接视频元数据、顶级评论、视频搜索结果和指定标签下的视频。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕,获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势,用于研究和监测。

