跳转到主要内容
POST
品牌提及

品牌提及

每一行都是网上某个提到查询词的网页:博客测评、新闻报道、论坛帖子、商品页面。除了网址和标题,还有提及处前后的段落、作者(如有)、网页语言和国家、站点类型,这段文字的正面、负面、中性情感占比,六种情绪分数,以及网页和所在域名的权威分、垃圾分。用 content_type 可以只看新闻或论坛;给词组加上英文双引号可以精确匹配。
通过 query 提供品牌、产品或话题(最多 100 个字符)。content_type 可以把结果限定为 news、blogs、message-boards、ecommerce 或 organization 类站点。results_limit 默认 100,可填 1–1000 之间的整数。每次请求计 10 积分,每个网页再加 0.02 积分;没有找到网页时同样收取 10 积分。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

通过 query 提供品牌、产品或话题(最多 100 个字符)。content_type 可以把结果限定为 news、blogs、message-boards、ecommerce 或 organization 类站点。results_limit 默认 100,可填 1–1000 之间的整数。每次请求计 10 积分,每个网页再加 0.02 积分;没有找到网页时同样收取 10 积分。

query
string
必填

要查找的品牌、产品或话题;用英文双引号包住词组可精确匹配。

Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

content_type
enum<string>

提及所在的站点类型:news、blogs、message-boards、ecommerce 或 organization。

可用选项:
blogs,
ecommerce,
message-boards,
news,
organization
Minimum string length: 1
results_limit
integer
默认值:100

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 1000

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object