品牌监测通常从两个问题开始:网上哪里在谈论我们?大家对我们是什么态度?第一个问题需要可以阅读和分派的网页级数据;第二个问题需要一个不必下载数百万网页就能画成图表的汇总。
SocQ 于 2026-11-17 上线了 Brand Monitoring 平台,每个问题对应一个接口。本文介绍它们返回什么、怎么请求、价格多少,以及各自适合的场景。
快速回答: 把品牌、产品或话题放进
query,发送到POST /v1/brand-monitoring/mentions,获取提到它的网页列表,每个网页带情感、情绪和权威度评分。把同样的query发送到POST /v1/brand-monitoring/sentiment,获取一行按情感和情绪拆分全部提及的汇总。轮询GET /v1/tasks/{task_id}读取结果。
新上线的品牌监测接口
1 SocQ 积分 = $0.005。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| Brand Mentions API(品牌提及) | 每个提到查询词的网页一行:URL、标题、提及处的段落、作者、语言、国家、站点类型、情感和情绪评分,以及页面和域名权威度 | 每次请求 10 积分($0.05)+ 每个网页 0.02 积分($0.0001) |
| Brand Sentiment Analysis API(品牌情感分析) | 一行汇总:把提到查询词的全部网页按主要情感和最强情绪分组,给出每组的网页数,以及贡献最多的站点、国家、语言和站点类型 | 每次调用 10 积分($0.05) |
Brand Mentions 在没有找到网页时,同样收取 10 积分基础费用。
鉴权与异步任务流程
所有 SocQ 请求都使用 API Key 鉴权,提交、任务状态和结果请求使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交响应中包含 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应会在 data.results.items 中带上第一页标准化结果。limit 默认 50,最大 500;如果 has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。任务处于 queued、running 或 failed 时,接口只返回任务元数据,不含 results。
在提交请求体中加入可选的 callback_url,任务结束后 SocQ 会发送一次带任务摘要的 POST;结果记录仍通过 GET /v1/tasks/{task_id} 读取。客户端超时不会取消任务,请用同一个任务 ID 继续查询,而不是重新提交并重复付费。402 表示积分不足;429 表示 API Key 触发了频率或积分限制。
Brand Mentions API:每一个提到你的网页
Brand Mentions API 返回全网提到查询词的网页:博客评测、新闻报道、论坛帖子和商品页。通过 query 提供品牌、产品或话题,最多 100 个字符。用双引号包住短语即可精确匹配。content_type 可以把结果限定为 news、blogs、message-boards、ecommerce 或 organization 类站点。results_limit 默认 100,可填 1 到 1,000。
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
}'
每行描述一个网页:
- 在哪里:
url、title、domain、language、country(两位字母代码,WW表示全球)和page_types,例如news、blogs或ecommerce。 - 说了什么:
text,即提及处的段落;有作者时给出author_name。 - 态度如何:
sentiment含positive、negative和neutral三个 0 到 1 的分数,三者相加为 1;emotions含六个 0 到 1 的分数:happiness、love、fun、share、sadness和anger。 - 分量多大:
content_quality_score(0 到 100)、spam_score(0 到 100,越高垃圾特征越多)、domain_rank和page_rank(0 到 1,000)。 - 何时:
fetched_at,网页最近一次被读取的时间。
权威度和垃圾评分可以给大量结果排序,让团队先看高权威、低垃圾的网页;情感拆分则能标出需要回应的网页。100 个网页计 12 积分($0.06),上限 1,000 个网页计 30 积分($0.15)。完整字段见 品牌提及文档。
只看媒体报道时,加上过滤条件:
{
"query": "\"notion ai\"",
"content_type": "news",
"results_limit": 200
}
Brand Sentiment Analysis API:数字背后的拆分
Brand Sentiment Analysis API 不返回单个网页,而是回答“网上对我们是什么态度”。提到查询词的网页按主要情感分组,并另外按最强情绪分组。每组给出包含的网页数,以及贡献最多的站点、国家、语言和站点类型。
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"
}'
唯一的结果行包含两个数组:
sentiments:positive、negative和neutral各一组。emotions:happiness、love、fun、share、sadness和anger各一组。
每组都有 label、mentions_count,以及 top_domains、countries、languages 和 page_types,每项都是按数量从大到小排列的 name 与 count 列表。借助这个结构,你可以判断批评来自新闻媒体还是某一个论坛,以及由哪些国家主导。每次请求 10 积分($0.05)。提及量达到数百万的宽泛词分析时间更长,可能需要几分钟,请耐心轮询。见 品牌情感分析文档。
该用哪个接口
- 每周舆情看板: 对你的品牌和每个竞品各跑一次 Brand Sentiment Analysis,保存数量并按时间画图。四个品牌每次共 40 积分($0.20)。
- 公关团队的处理队列: 运行 Brand Mentions,把
content_type设为news或message-boards,再按negative情感分数和domain_rank排序。 - 排查舆情突增: 情感数量出现波动时,查看负面组的
top_domains找出主要来源站点,再用 Brand Mentions 拉取这些网页。
两个接口处理的都是上述五类站点的网页。社交网络上的帖子和评论请使用各平台接口,详见 统一社交媒体 API 指南。想了解 AI 助手如何谈论你的品牌,请看 AI 搜索 API 指南。
常见问题
什么是品牌监测 API?
一种找出品牌、产品或话题在哪里被提及、以及这些提及态度如何的 API。SocQ 的版本返回带情感、情绪和权威度评分的网页级提及,以及按情感和情绪汇总的拆分。
如何精确匹配一个短语?
在 query 中用双引号把短语包起来,例如 JSON 中写作 "\"notion ai\""。查询词最多 100 个字符。
覆盖哪些类型的站点?
网页分为 news、blogs、message-boards、ecommerce 和 organization 五类。Brand Mentions 可以通过 content_type 限定为其中一类。
什么都没找到也收费吗?
Brand Mentions 在没有找到网页时也收取 10 积分基础费用,另按每个返回的网页加 0.02 积分。Brand Sentiment Analysis 每次请求 10 积分。
为什么我的情感分析任务还在运行?
提及量达到数百万的宽泛词分析时间更长,可能需要几分钟。请继续轮询同一个 task_id,不要重新提交。