content_analysis/overview

#分析 API 概览

分析 API 可用于品牌监测、绪分析与提及管理，适合围绕目标、品牌词或主题追踪网络中的，并分析绪倾向。

本接口可识别文本中的正向、负向、中性绪极性，并进一步判断以下绪语义标签：

愤怒
快乐
喜爱
悲伤
分享意愿
趣味

当前分析 API 提供以下端点：

搜索
路径：/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/
作用：按日期返回目标分类下的提及趋势数据。

Search 端点能力说明

通过 /v3/content_analysis/search/live/，你可以：

指定返回结果数量
对结果进行过滤
对结果进行排序

使用过滤和排序规则不会产生额外费用。搜索端点支持对返回数据集应用自定义过滤条件，便于快速提取所需数据。过滤规则请参考分析 API 的过滤器说明文档。

数据获取方式

分析 API 支持 Live 实时调用方式。

这意味着：

无需拆分为单独的 POST 与 GET 轮询流程
请求提交后可直接获得结果
适合实时查询和在线分析场景

调用限制

默认支持最高 2000 次 API 调用/分钟
如需更高并发额度，可联系平台支持提升限制

认证方式

所有请求均需在请求头中传 Bearer Token：

bash

Authorization: Bearer smt_live_YOUR_KEY

请求格式

分析 API 的 POST 请求体使用 JSON 数组格式：

json

[
 {
 "keyword": "your target keyword"
 }
]

请求示例

cURL

bash

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": "nike"
 }
 ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/content_analysis/summary/live/"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "keyword": "nike"
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json)

TypeScript

typescript

const response = await fetch("https://api.seermartech.cn/v3/content_analysis/summary/live/", {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([
 {
 keyword: "nike"
 }
 ])
});

const data = await response.json;
console.log(response.status);
console.log(data);

计费说明

分析 API 的费用取决于调用的端点与请求参数。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

你也可以通过用户数据接口查看账户余额、消耗与额信息。

测试说明

可通过沙盒能力对接口进行联调与功能验证，再切换至正式环境发起真实请求。

常见返回信息

不同端点的响应结构会有所差异，但通常会以下通用字段：

字段	类型	说明
`version`	string	API 版本号
`status_code`	integer	任务状态码
`status_message`	string	状态说明
`time`	string	请求处理耗时
`cost`	number	本次请求扣费
`tasks_count`	integer	本次请求中的任务数量
`tasks_error`	integer	出错任务数量
`tasks`	array	任务结果列表

错误处理说明

分析 API 各端点通常通过以下信息判断调用结果：

顶层 status_code 与 status_message
tasks 中各任务的执行状态
tasks_error 是否大于 0

排查异常时，建议重点检查：

认证信息是否正确
请求体是否为 JSON 数组 [{ ... }] -填参数如 keyword 是否填写
过滤与排序规则格式是否正确
请求频率是否每分钟限制

适用端点汇总

功能	路径	用途
搜索	`/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/`	获取分类维度时间趋势

实用场景

监测品牌口碑：持续追踪品牌词在中的提及，及时发现舆波动并响应。
分析用户绪：识别正向、负向、中性评价及细分绪标签，帮助市场团队评估活动反馈与产品口碑。
定位高价值引用：通过搜索、过滤和排序快速找出高、高影响力的提及页面，用于外链和合作挖掘。
跟踪热点趋势：结合短语趋势与分类趋势，观察某个主题在不同时间段和类别中的热度变化，支持选题策划与投放。
评估质量分布：利用评分分布查看目标主题的整体质量层级，竞品研究与生态分析。

content_analysis/overview ​

Search 端点能力说明 ​

数据获取方式 ​

调用限制 ​

认证方式 ​

请求格式 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

计费说明 ​

测试说明 ​

常见返回信息 ​

错误处理说明 ​

适用端点汇总 ​

实用场景 ​