返回 API
品牌监测数据

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 APIBrand Sentiment Analysis API
结果每个网页一行每个 query 一行汇总
情感每个网页段落的评分各情感组和情绪组的网页数
来源每个网页的域名、作者、站点类型和权威度每组的主要域名、国家、语言和网页类型
筛选query、content_type,results_limit 最多 1,000query
计费每次请求 10 积分,另加每个网页 0.02 积分每次请求 10 积分

Brand Monitoring API 如何工作

两个 API 使用相同的异步任务流程。

  1. 1. 提交 query

    把品牌、产品或话题 POST 到 /v1/brand-monitoring/mentions 或 /v1/brand-monitoring/sentiment。

  2. 2. 跟踪任务

    轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded;宽泛的词可能需要几分钟。

  3. 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 积分。

将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。