content_analysis/overview

#分析 API 概览

分析 API 可用于品牌监测、感分析和品牌引用管理，帮助你发现目标或品牌在网页中的提及，并分析文本的感倾向。

本接口支持识别文本中的以下感极性：

• 正面
• 负面
• 中性

同时支持检测以下感涵：

• 愤怒
• 快乐
• 喜爱
• 悲伤
• 分享意愿（希望分享）
• 趣味性

接口列表

分析 API 当前提供以下 Live 接口：

功能	说明	接口路径
引用搜索	查找目标或品牌的所有引用，并返回每条引用的详细信息	POST /v3/content_analysis/search/live/
引用摘要	汇总目标或品牌的引用数据	POST /v3/content_analysis/summary/live/
感分析	按正面、负面、中性感极性，以及感涵统计引用数据	POST /v3/content_analysis/sentiment_analysis/live/
评分分布	按评分统计引用数据分布	POST /v3/content_analysis/rating_distribution/live/
短语趋势	按日期返回目标或品牌的引用统计趋势	POST /v3/content_analysis/phrase_trends/live/
类别趋势	按日期返回指定类别中的引用趋势	POST /v3/content_analysis/category_trends/live/

引用搜索

引用搜索接口支持：

• 指定需要返回的结果数量
• 按条件筛选数据
• 对结果进行排序
• 获取每条引用的详细信息

筛选和排序规则不会产生额外费用。通过自定义过滤条件，可以获取符合业务要求的引用数据。

接口路径：

POST https://api.seermartech.cn/v3/content_analysis/search/live/

可用过滤条件，请参考分析 API 的过滤器说明：

/v3/content_analysis/filters/

请求格式

Live 接口通过一次 POST 请求直接返回结果，不需要提交任务、再发送 GET 请求查询结果。

POST 请求体统一使用 JSON 数组格式：

[
  {
    "keyword": "示例品牌",
    "language_code": "zh-CN",
    "location_code": 2156
  }
]

> 字段及可选参数以对应功能接口的参数说明为准。

认证方式

请求时需在 Authorization 请求头中携带 API 密钥：

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

示例：

curl -X POST "https://api.seermartech.cn/v3/content_analysis/summary/live/" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keyword": "示例品牌",
      "language_code": "zh-CN",
      "location_code": 2156
    }
  ]'

调用限制

本接口支持 Live 实时数据获取方式：

• 无需异步任务创建和结果轮询 平台限流以认证说明中的 30/60/120 次/分钟规则为准- 如需提升调用频率上限，请联系平台技术支持

计费说明

分析 API 按请求和返回数据计费。筛选与排序规则不会额外收费。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

测试环境可使用沙箱功能：

/v3/appendix/sandbox/

接口

• 引用搜索：/v3/content_analysis/search/live/
• 引用摘要：/v3/content_analysis/summary/live/ -感分析：/v3/content_analysis/sentiment_analysis/live/
• 评分分布：/v3/content_analysis/rating_distribution/live/
• 短语趋势：/v3/content_analysis/phrase_trends/live/
• 类别趋势：/v3/content_analysis/category_trends/live/ -分析过滤器：/v3/content_analysis/filters/
• 用户数据：/v3/appendix/user_data/

实用场景

• 监测品牌提及：搜索新闻、博客和行业网站中的品牌引用，及时发现品牌机会与潜在声誉风险。
• 分析舆感：统计品牌或的正面、负面和中性提及，评估营销活动及事件的影响。
• 跟踪品牌声量趋势：按日期分析引用量变化，识别传播高峰和搜索需求变化。
• 评估传播价值：结合评分分布和分享、快乐、趣味等感涵，筛选更传播潜力的。
• 对比行业类别表现：按指定类别查看引用趋势，评估品牌在不同垂直领域中的度和竞争表现。