内容分析 – 情感分析 API

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "keyword_fields": {},
  "page_type": [
    "<string>"
  ],
  "internal_list_limit": 123,
  "positive_connotation_threshold": 123,
  "sentiments_connotation_threshold": 123,
  "initial_dataset_filters": [
    "<string>"
  ],
  "rank_scale": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live"

payload = {
    "keyword": "<string>",
    "keyword_fields": {},
    "page_type": ["<string>"],
    "internal_list_limit": 123,
    "positive_connotation_threshold": 123,
    "sentiments_connotation_threshold": 123,
    "initial_dataset_filters": ["<string>"],
    "rank_scale": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keyword: '<string>',
    keyword_fields: {},
    page_type: ['<string>'],
    internal_list_limit: 123,
    positive_connotation_threshold: 123,
    sentiments_connotation_threshold: 123,
    initial_dataset_filters: ['<string>'],
    rank_scale: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keyword' => '<string>',
    'keyword_fields' => [
        
    ],
    'page_type' => [
        '<string>'
    ],
    'internal_list_limit' => 123,
    'positive_connotation_threshold' => 123,
    'sentiments_connotation_threshold' => 123,
    'initial_dataset_filters' => [
        '<string>'
    ],
    'rank_scale' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ],
  "tasks.result.type": "<string>",
  "tasks.result.positive_connotation_distribution": {},
  "tasks.result.positive_connotation_distribution.$positive": {},
  "tasks.result.positive_connotation_distribution.$positive.type": "<string>",
  "tasks.result.positive_connotation_distribution.$positive.total_count": 123,
  "tasks.result.positive_connotation_distribution.$positive.rank": 123,
  "tasks.result.positive_connotation_distribution.$positive.top_domains": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.sentiment_connotations": {},
  "tasks.result.positive_connotation_distribution.$positive.connotation_types": {},
  "tasks.result.positive_connotation_distribution.$positive.text_categories": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.page_categories": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.page_types": {},
  "tasks.result.positive_connotation_distribution.$positive.countries": {},
  "tasks.result.positive_connotation_distribution.$positive.languages": {},
  "tasks.result.sentiment_connotation_distribution": {},
  "tasks.result.sentiment_connotation_distribution.$anger": {},
  "tasks.result.sentiment_connotation_distribution.$anger.type": "<string>",
  "tasks.result.sentiment_connotation_distribution.$anger.total_count": 123,
  "tasks.result.sentiment_connotation_distribution.$anger.rank": 123,
  "tasks.result.sentiment_connotation_distribution.$anger.top_domains": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.sentiment_connotations": {},
  "tasks.result.sentiment_connotation_distribution.$anger.connotation_types": {},
  "tasks.result.sentiment_connotation_distribution.$anger.text_categories": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.page_categories": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.page_types": {},
  "tasks.result.sentiment_connotation_distribution.$anger.countries": {},
  "tasks.result.sentiment_connotation_distribution.$anger.languages": {}
}

POST

https://api.aisa.one/apis/v1

dataforseo

content_analysis

sentiment_analysis

live

内容分析 – 情感分析 API

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "keyword_fields": {},
  "page_type": [
    "<string>"
  ],
  "internal_list_limit": 123,
  "positive_connotation_threshold": 123,
  "sentiments_connotation_threshold": 123,
  "initial_dataset_filters": [
    "<string>"
  ],
  "rank_scale": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live"

payload = {
    "keyword": "<string>",
    "keyword_fields": {},
    "page_type": ["<string>"],
    "internal_list_limit": 123,
    "positive_connotation_threshold": 123,
    "sentiments_connotation_threshold": 123,
    "initial_dataset_filters": ["<string>"],
    "rank_scale": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keyword: '<string>',
    keyword_fields: {},
    page_type: ['<string>'],
    internal_list_limit: 123,
    positive_connotation_threshold: 123,
    sentiments_connotation_threshold: 123,
    initial_dataset_filters: ['<string>'],
    rank_scale: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keyword' => '<string>',
    'keyword_fields' => [
        
    ],
    'page_type' => [
        '<string>'
    ],
    'internal_list_limit' => 123,
    'positive_connotation_threshold' => 123,
    'sentiments_connotation_threshold' => 123,
    'initial_dataset_filters' => [
        '<string>'
    ],
    'rank_scale' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"internal_list_limit\": 123,\n  \"positive_connotation_threshold\": 123,\n  \"sentiments_connotation_threshold\": 123,\n  \"initial_dataset_filters\": [\n    \"<string>\"\n  ],\n  \"rank_scale\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ],
  "tasks.result.type": "<string>",
  "tasks.result.positive_connotation_distribution": {},
  "tasks.result.positive_connotation_distribution.$positive": {},
  "tasks.result.positive_connotation_distribution.$positive.type": "<string>",
  "tasks.result.positive_connotation_distribution.$positive.total_count": 123,
  "tasks.result.positive_connotation_distribution.$positive.rank": 123,
  "tasks.result.positive_connotation_distribution.$positive.top_domains": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.sentiment_connotations": {},
  "tasks.result.positive_connotation_distribution.$positive.connotation_types": {},
  "tasks.result.positive_connotation_distribution.$positive.text_categories": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.page_categories": [
    "<string>"
  ],
  "tasks.result.positive_connotation_distribution.$positive.page_types": {},
  "tasks.result.positive_connotation_distribution.$positive.countries": {},
  "tasks.result.positive_connotation_distribution.$positive.languages": {},
  "tasks.result.sentiment_connotation_distribution": {},
  "tasks.result.sentiment_connotation_distribution.$anger": {},
  "tasks.result.sentiment_connotation_distribution.$anger.type": "<string>",
  "tasks.result.sentiment_connotation_distribution.$anger.total_count": 123,
  "tasks.result.sentiment_connotation_distribution.$anger.rank": 123,
  "tasks.result.sentiment_connotation_distribution.$anger.top_domains": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.sentiment_connotations": {},
  "tasks.result.sentiment_connotation_distribution.$anger.connotation_types": {},
  "tasks.result.sentiment_connotation_distribution.$anger.text_categories": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.page_categories": [
    "<string>"
  ],
  "tasks.result.sentiment_connotation_distribution.$anger.page_types": {},
  "tasks.result.sentiment_connotation_distribution.$anger.countries": {},
  "tasks.result.sentiment_connotation_distribution.$anger.languages": {}
}

某关键词全部引用的情感分布：positive_connotation_distribution（positive / negative / neutral）和 sentiment_connotation_distribution（anger / happiness / love / sadness / share / fun）。positive_connotation_threshold 和 sentiments_connotation_threshold 决定判定要多高置信度才算数。实测 5.7 KB。响应统一包在 DataForSEO 的信封里——数据在 tasks[0].result，上游扣费在 tasks[0].cost。 ⚠️ 这两个块 post_dataforseo_content_summary_live 里都有，价格相同还多给域名、类目、国家和语言——除非小响应体对你有意义，否则优先用它。要看情感按星级拆开，用 post_dataforseo_content_rating_distribution_live。

示例

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/content_analysis/sentiment_analysis/live" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"keyword": "...", "keyword_fields": "...", "page_type": "..."}]'

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

keyword

string

必填

目标关键词，必填字段，采用 UTF-8 编码。关键词将转换为小写格式；注意：如需匹配完整短语而非独立关键词，请使用双引号和反斜杠；示例："keyword": ""tesla palo alto""。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅此帮助中心文章。

keyword_fields

object

目标关键词字段和目标关键词，可选字段。使用此参数可按特定字段应包含的关键词筛选数据集；可指定的字段：title、main_title、previous_title、snippet。您可以指定多个字段；注意：若要匹配完整短语而非独立关键词，请使用双引号和反斜杠；示例："keyword_fields": { "snippet": ""logitech mouse"", "main_title": "sale" }

page_type

string[]

目标页面类型，可选字段。使用此参数按页面类型筛选数据集；可能的值："ecommerce"、"news"、"blogs"、"message-boards"、"organization"

internal_list_limit

integer

内部数组中的最大元素数量，可选字段；你可以使用此字段限制以下数组中的元素数量：top_domains、text_categories、page_categories、countries、languages；默认值：1；最大值：20

positive_connotation_threshold

number

正面倾向阈值。可选字段。指定为与引用内容相关的正面情感概率指数阈值。如果指定此字段，响应中的 connotation_types 对象将仅包含正面情感概率大于或等于指定值的引用数据。可选值：0 到 1。默认值：0.4

sentiments_connotation_threshold

number

情感内涵阈值，可选字段。指定为与引用内容相关的情感内涵概率指数阈值。如果指定此字段，响应中的 sentiment_connotations 对象将仅包含各项情感概率大于或等于指定值的引用数据。可选值：0 到 1。默认值：0.4

initial_dataset_filters

string[]

初始数据集过滤参数，可选字段。应用于 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。有关初始数据集过滤器的更多信息，请参阅此帮助中心文章。

rank_scale

string

定义用于计算和显示排名值的刻度，可选字段。您可以使用此参数选择以 0–100 还是 0–1000 刻度显示排名值。可选值：one_hundred — 以 0–100 刻度显示排名值；one_thousand — 以 0–1000 刻度显示排名值。默认值：one_thousand。有关此参数工作原理的更多信息，请参阅此帮助中心文章。

tag

string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version

string

API 的当前版本

status_code

integer

通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message

string

常规信息消息；可在此处查看常规信息消息的完整列表

time

string

执行时间（秒）

cost

number

任务总成本（美元）

tasks_count

integer

tasks 数组中的任务数量

tasks_error

integer

返回错误的 tasks 数组中的任务数量

tasks

string[]

任务数组

tasks.id

string

任务标识符，系统中采用 UUID 格式的唯一任务标识符

tasks.status_code

integer

DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看

tasks.status_message

string

任务的信息性消息，你可以在此处查看通用信息性消息的完整列表

tasks.time

string

执行时间（秒）

tasks.cost

number

任务成本（美元）

tasks.result_count

integer

结果数组中的元素数量

tasks.path

string[]

URL 路径

tasks.data

object

包含您在 POST 请求中指定的相同参数

tasks.result

string[]

结果数组

tasks.result.type

string

元素类型 = ‘content_analysis_sentiment_analysis’

tasks.result.positive_connotation_distribution

object

按情感内涵类型划分的引用分布；包含按情感类型（情感极性）分布的引用次数及相关数据的对象。可能的情感内涵类型：positive、negative、neutral。

tasks.result.positive_connotation_distribution.$positive

object

正面、负面或中性含义；变量可取以下值：positive、negative、neutral

tasks.result.positive_connotation_distribution.$positive.type

string

元素类型 = ‘content_analysis_summary’

tasks.result.positive_connotation_distribution.$positive.total_count

integer

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

内容分析 – 情感分析 API

示例

授权

请求体

响应

​示例

授权

请求体

响应

示例