DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – 情感分析 API
某个关键词引用的情感分布：positive_connotation_distribution（positive、negative、neutral）和 sentiment_connotation_distribution（anger、happiness、love、sadness、share、fun）。positive_connotation_threshold 和 sentiments_connotation_threshold 设定分类需要达到的置信度才会计入。⚠️ 这两个区块已经包含在 post_dataforseo_content_summary_live 中，后者费用相同，还额外提供域名、分类、国家和语言——除非响应体积更重要，否则优先使用它。若要查看按星级评分划分的情感分布，请使用 post_dataforseo_content_rating_distribution_live。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.024 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array (object | null)[]
- initial类型: array (object | null)[] | null
_dataset _filters 初始数据集筛选参数 可选字段 适用于 Search 端点中字段的初始筛选参数 可同时添加多个筛选条件（最多 8 个） 应在条件之间设置逻辑运算符 and、or 支持以下运算符： regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like、has、has_not、match、not_match 可在 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 有关初始数据集筛选条件的更多信息，请参阅这篇帮助中心文章。
空对象 - internal类型: integer | null
_list _limit 内部数组中的最大元素数量 可选字段 可使用此字段限制以下数组中的元素数量： top_domains text_categories page_categories countries languages 默认值：1 最大值：20
- keyword类型: string
目标关键词 必填字段 UTF-8 编码 关键词将转换为小写格式； 注意：如需匹配完整短语而非单个关键词，请使用双引号和反斜杠； 示例： "keyword": ""tesla palo alto"" 有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇帮助中心文章
- keyword类型: object | null
_fields 目标关键词字段与目标关键词 可选字段 使用此参数按特定字段应包含的关键词筛选数据集； 可指定的字段：title、main_title、previous_title、snippet 可指定多个字段； 注意：如需匹配完整短语而非单个关键词，请使用双引号和反斜杠； 示例： "keyword_fields": { "snippet": ""logitech mouse"", "main_title": "sale" }
- property类型: string | null
Name
- page类型: array string[] | null
_type 目标页面类型 可选字段 使用此参数按页面类型筛选数据集 可能的值： "ecommerce"、"news"、"blogs"、"message-boards"、"organization"
- positive类型: number | null
_connotation _threshold 正面情感阈值 可选字段 以与引用内容相关的正面情感概率指数阈值表示 如果指定此字段，响应中的 connotation_types 对象将仅包含正面情感概率大于或等于指定值的引用数据 可能的值：0 到 1 默认值：0.4
- rank类型: string | null
_scale 定义用于计算和显示 rank 值的量级 可选字段 可使用此参数选择 rank 值以 0–100 还是 0–1000 的量级呈现 可能的值： one_hundred — rank 值以 0–100 的量级显示 one_thousand — rank 值以 0–1000 的量级显示 默认值：one_thousand 有关此参数工作方式的更多信息，请参阅这篇帮助中心文章
- sentiments类型: number | null
_connotation _threshold 情感倾向阈值 可选字段 以与引用内容相关的情感倾向概率指数阈值表示 如果指定此字段，响应中的 sentiment_connotations 对象将仅包含各情感概率均大于或等于指定值的引用数据 可能的值：0 到 1 默认值：0.4
- tag类型: string | null
用户自定义任务标识符 可选字段 字符数上限为 255 可使用此参数标识任务，并将其与结果对应 可在响应的 data 对象中找到指定的 tag 值
- 类型: object | null · Response36Afe1097B20_ContentAnalysisSentimentAnalysisLiveResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用，美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_ContentAnalysisSentimentAnalysisLiveTaskInfo
- cost类型: number | null 格式: double
任务总费用，美元
- data类型: object | null
包含你在 POST 请求中指定的相同参数
- property类型: object | null
Name
- id类型: string | null
任务标识符 我们系统中 UUID 格式的唯一任务标识符
- path类型: array (string | null)[] | null
URL 路径
- result类型: array (object | null)[] | null
结果数组
- positive类型: object | null · Response36Afe1097B20_PositiveConnotationDistribution
_connotation _distribution 按情感含义类型划分的引用分布 包含按情感类型（情感极性）分布的引用次数及相关数据的对象； 可能的情感含义类型：positive、negative、neutral
- negative类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- neutral类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- positive类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- sentiment类型: object | null · Response36Afe1097B20_SentimentConnotationDistribution
_connotation _distribution 按情感含义划分的引用分布 包含按情感（情绪反应）分布的引用次数及相关数据的对象； 可能的情感含义类型：anger、happiness、love、sadness、share、fun
- anger类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- fun类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- happiness类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- love类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- sadness类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- share类型: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo
- connotation类型: object | null
_types 情感含义类型
包含与关键词引用相关的情感类型（情感极性），以及每种情感类型的引用次数
可能的情感含义类型：positive、negative、neutral- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- countries类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- languages类型: object | null
- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- page类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- page类型: object | null
_types 页面类型
包含页面类型及每种页面类型的引用次数- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- rank类型: integer | null
引用
keyword的所有 URL 的排名
引用目标keyword的所有 URL 排名的归一化总和 - sentiment类型: object | null
_connotations 情感含义
包含与目标关键词引用相关的情感（情绪反应），以及每种情感的引用次数
可能的情感含义：anger、happiness、love、sadness、share、fun- property类型: integer | null 格式: int64
Name Signed 64-bit integers (long type).
- text类型: array (object | null)[] | null
_categories - category类型: array (integer | null)[] | null
- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- top类型: array (object | null)[] | null
_domains 引用目标关键词的热门域名
包含引用目标关键词的热门域名对象，以及每个域名的引用次数- count类型: integer | null 格式: int64
Signed 64-bit integers (long type).
- domain类型: string | null
- total类型: integer | null 格式: int64
_count 我们数据库中与你的请求相关的结果总数
- type类型: string | null
元素类型
- type类型: string | null
元素类型
- result类型: integer | null 格式: int64
_count result 数组中的元素数
- status类型: integer | null
_code 任务的状态码 由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处
- status类型: string | null
_message 任务的信息性消息 完整的一般信息性消息列表见此处
- time类型: string | null
执行时间，秒
- 类型: integer | null 格式: int64tasks
_count tasks 数组中的任务数
- 类型: integer | null 格式: int64tasks
_error tasks 数组中返回错误的任务数
- 类型: string | nulltime
总执行时间，秒
- 类型: string | nullversion
API 的当前版本
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/sentiment_analysis/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"internal_list_limit": 1
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"type": null,
"positive_connotation_distribution": {
"positive": "[Max Depth Exceeded]",
"negative": "[Max Depth Exceeded]",
"neutral": "[Max Depth Exceeded]"
},
"sentiment_connotation_distribution": {
"anger": "[Max Depth Exceeded]",
"happiness": "[Max Depth Exceeded]",
"love": "[Max Depth Exceeded]",
"sadness": "[Max Depth Exceeded]",
"share": "[Max Depth Exceeded]",
"fun": "[Max Depth Exceeded]"
}
}
]
}
]
}