> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 内容分析 – 摘要 API
> 某个关键词在全网被引用情况的聚合视图。
某个关键词在全网被引用情况的聚合视图。返回 `total_count`、`rank`、`top_domains`（每项含 `domain` 和 `count`）、`sentiment_connotations`（anger / happiness / love / sadness / share / fun）、`connotation_types`（positive / negative / neutral）、`text_categories`、`page_categories`、`page_types`、`countries` 和 `languages`。单个关键词实测 1.1 KB。响应统一包在 DataForSEO 的信封里——数据在 `tasks[0].result`。 这是 content 家族的中枢：`post_dataforseo_content_sentiment_analysis_live` 返回的两个 connotation 块本接口已经包含，除非你就是要更小的响应体，否则直接用这个。要逐个引用页面而非总数，用 `post_dataforseo_content_search_live`；要同样的聚合按时间展开，用 `post_dataforseo_content_phrase_trends_live`。
## 示例
```bash REST theme={null}
curl -X POST "https://api.aisa.one/apis/v1/dataforseo/content_analysis/summary/live" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '[{"keyword": "...", "keyword_fields": "...", "page_type": "..."}]'
```
```jsonc MCP theme={null}
// 把整段复制给 Claude Code、Codex、Cursor 或任意 coding agent。
// 连接、授权、跑通这个例子需要的东西都在里面 ——
// 不用粘贴任何 key，浏览器里点一次 Allow 就好。
{
"operation_id": "post_dataforseo_content_summary_live",
"arguments": {},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/zh/api-reference/dataforseo/post_dataforseo-content-analysis-summary-live.md
// Then run the call and show me the result.
```
**第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
[aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/dataforseo/post_dataforseo-content-analysis-summary-live)
## OpenAPI
````yaml openapi/zh/dataforseo.json POST /dataforseo/content_analysis/summary/live
openapi: 3.0.3
info:
title: DataForSEO API
version: 1.0.0
description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
- url: https://api.aisa.one/apis/v1
security:
- BearerAuth: []
paths:
/dataforseo/content_analysis/summary/live:
post:
summary: 内容分析 – 摘要 API
description: >-
某个关键词在全网被引用情况的聚合视图。返回 `total_count`、`rank`、`top_domains`（每项含 `domain` 和
`count`）、`sentiment_connotations`（anger / happiness / love / sadness /
share / fun）、`connotation_types`（positive / negative /
neutral）、`text_categories`、`page_categories`、`page_types`、`countries` 和
`languages`。单个关键词实测 1.1 KB。响应统一包在 DataForSEO 的信封里——数据在
`tasks[0].result`。 这是 content
家族的中枢：`post_dataforseo_content_sentiment_analysis_live` 返回的两个
connotation 块本接口已经包含，除非你就是要更小的响应体，否则直接用这个。要逐个引用页面而非总数，用
`post_dataforseo_content_search_live`；要同样的聚合按时间展开，用
`post_dataforseo_content_phrase_trends_live`。
operationId: post_dataforseo_content_summary_live
requestBody:
required: true
content:
application/json:
schema:
type: array
items:
type: object
properties:
keyword:
type: string
description: >-
目标关键词，必填字段，采用 UTF-8
编码。关键词将转换为小写格式；注意：如需匹配完整短语而非独立关键词，请使用双引号和反斜杠；示例："keyword":
"\"tesla palo alto\""。有关 DataForSEO API 中 keyword 和
keywords 字段的规则与限制，请参阅此帮助中心文章。
keyword_fields:
type: object
description: >-
目标关键词字段和目标关键词，可选字段。使用此参数可按特定字段应包含的关键词筛选数据集；可指定的字段：title、main_title、previous_title、snippet。您可以指定多个字段；注意：若要匹配完整短语而非独立关键词，请使用双引号和反斜杠；示例："keyword_fields":
{ "snippet": "\"logitech mouse\"", "main_title": "sale" }
properties:
title:
type: string
main_title:
type: string
previous_title:
type: string
snippet:
type: string
page_type:
type: array
items:
type: string
description: >-
目标页面类型，可选字段。使用此参数按页面类型筛选数据集；可能的值："ecommerce"、"news"、"blogs"、"message-boards"、"organization"
internal_list_limit:
type: integer
description: >-
内部数组中的最大元素数量，可选字段；你可以使用此字段限制以下数组中的元素数量：top_domains、text_categories、page_categories、countries、languages；默认值：1；最大值：20
positive_connotation_threshold:
type: number
description: >-
正面倾向阈值。可选字段。指定为与引用内容相关的正面情感概率指数阈值。如果指定此字段，响应中的
connotation_types 对象将仅包含正面情感概率大于或等于指定值的引用数据。可选值：0 到
1。默认值：0.4
sentiments_connotation_threshold:
type: number
description: >-
情感内涵阈值，可选字段。指定为与引用内容相关的情感内涵概率指数阈值。如果指定此字段，响应中的
sentiment_connotations 对象将仅包含各项情感概率大于或等于指定值的引用数据。可选值：0 到
1。默认值：0.4
initial_dataset_filters:
type: array
items: {}
description: >-
初始数据集过滤参数，可选字段。应用于 Search 端点中字段的初始过滤参数。可以同时添加多个过滤器（最多 8
个）。应在条件之间设置逻辑运算符 and、or。支持以下运算符：regex、not_regex、 、
、>、>=、=、 、in、not_in、like、not_like、has、has_not。可以将 % 运算符与
like 和 not_like 配合使用，以匹配由零个或多个字符组成的任意字符串。示例：["domain","",
"logitech.com"]
[["domain","","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]
[["domain","","logitech.com"]], "and",
[["content_info.connotation_types.negative",">",1000],
"or",
["content_info.text_category","has",10994]]]。有关过滤器的更多信息，请参阅
Content Analysis API – Filters；有关初始数据集过滤器的更多信息，请参阅此帮助中心文章。
rank_scale:
type: string
description: >-
定义用于计算和显示排名值的刻度，可选字段。您可以使用此参数选择以 0–100 还是 0–1000
刻度显示排名值。可选值：one_hundred — 以 0–100 刻度显示排名值；one_thousand — 以
0–1000 刻度显示排名值。默认值：one_thousand。有关此参数工作原理的更多信息，请参阅此帮助中心文章。
tag:
type: string
description: >-
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的
data 对象中找到指定的 tag 值
required:
- keyword
responses:
'200':
description: 成功响应
content:
application/json:
schema:
type: object
properties:
version:
type: string
description: API 的当前版本
status_code:
type: integer
description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况
status_message:
type: string
description: 常规信息消息；可在此处查看常规信息消息的完整列表
time:
type: string
description: 执行时间（秒）
cost:
type: number
description: 任务总成本（美元）
tasks_count:
type: integer
description: tasks 数组中的任务数量
tasks_error:
type: integer
description: 返回错误的 tasks 数组中的任务数量
tasks:
type: array
items:
type: string
description: 任务数组
tasks.id:
type: string
description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符
tasks.status_code:
type: integer
description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看
tasks.status_message:
type: string
description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表
tasks.time:
type: string
description: 执行时间（秒）
tasks.cost:
type: number
description: 任务成本（美元）
tasks.result_count:
type: integer
description: 结果数组中的元素数量
tasks.path:
type: array
items:
type: string
description: URL 路径
tasks.data:
type: object
description: 包含您在 POST 请求中指定的相同参数
tasks.result:
type: array
items:
type: string
description: 结果数组
tasks.result.type:
type: string
description: 元素类型 = ‘content_analysis_summary’
tasks.result.total_count:
type: integer
description: 数据库中与您的请求相关的结果总量
tasks.result.rank:
type: integer
description: 引用该关键词的所有 URL 的排名，即引用目标关键词的所有 URL 排名的归一化总和
tasks.result.top_domains:
type: array
items:
type: string
description: 引用目标关键词的热门域名，包含引用目标关键词的热门域名对象以及每个域名的引用次数
tasks.result.sentiment_connotations:
type: object
description: >-
sentiment connotations
包含与目标关键词引用相关的情绪（情感反应），以及每种情绪对应的引用数量。可能的 sentiment
connotations：anger、happiness、love、sadness、share、fun
tasks.result.connotation_types:
type: object
description: >-
内涵类型，包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数；可能的情感内涵类型：positive、negative、neutral
tasks.result.text_categories:
type: array
items:
type: string
description: >-
文本类别，包含由文本类别及各类别引用次数组成的对象。如需获取所有可用类别的完整列表，请参阅 Categories
端点
tasks.result.page_categories:
type: array
items:
type: string
description: >-
页面类别，包含由页面类别以及各页面类别中的引用次数构成的对象。如需获取所有可用类别的完整列表，请参阅
Categories 端点
tasks.result.page_types:
type: object
description: 页面类型，包含各页面类型及其引用次数
tasks.result.countries:
type: object
description: countries 包含各个国家及其引用次数；如需获取完整的可用国家列表，请参阅 Locations 端点。
tasks.result.languages:
type: object
description: languages 包含各种语言及每种语言的引用次数；要获取可用语言的完整列表，请参阅 Languages 端点
'400':
description: 错误请求
'401':
description: 未授权
'429':
description: 超出速率限制
'500':
description: 内部服务器错误
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.