跳转到主要内容
POST
https://api.aisa.one/apis/v1
/
dataforseo
/
content_analysis
/
search
/
live
内容分析 – 搜索 API
curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/content_analysis/search/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keyword": "<string>",
  "keyword_fields": {},
  "page_type": [
    "<string>"
  ],
  "search_mode": "<string>",
  "limit": 123,
  "filters": [
    "<string>"
  ],
  "order_by": [
    "<string>"
  ],
  "offset": 123,
  "offset_token": "<string>",
  "rank_scale": "<string>",
  "tag": "<string>"
}
'
import requests

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

payload = {
    "keyword": "<string>",
    "keyword_fields": {},
    "page_type": ["<string>"],
    "search_mode": "<string>",
    "limit": 123,
    "filters": ["<string>"],
    "order_by": ["<string>"],
    "offset": 123,
    "offset_token": "<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>'],
    search_mode: '<string>',
    limit: 123,
    filters: ['<string>'],
    order_by: ['<string>'],
    offset: 123,
    offset_token: '<string>',
    rank_scale: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/content_analysis/search/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/search/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>'
    ],
    'search_mode' => '<string>',
    'limit' => 123,
    'filters' => [
        '<string>'
    ],
    'order_by' => [
        '<string>'
    ],
    'offset' => 123,
    'offset_token' => '<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/search/live"

	payload := strings.NewReader("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"search_mode\": \"<string>\",\n  \"limit\": 123,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"offset_token\": \"<string>\",\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/search/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keyword\": \"<string>\",\n  \"keyword_fields\": {},\n  \"page_type\": [\n    \"<string>\"\n  ],\n  \"search_mode\": \"<string>\",\n  \"limit\": 123,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"offset_token\": \"<string>\",\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/search/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  \"search_mode\": \"<string>\",\n  \"limit\": 123,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"offset_token\": \"<string>\",\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.offset_token": "<string>",
  "tasks.result.total_count": 123,
  "tasks.result.items_count": 123,
  "tasks.result.items": [
    "<string>"
  ],
  "tasks.result.items.type": "<string>",
  "tasks.result.items.url": "<string>",
  "tasks.result.items.domain": "<string>",
  "tasks.result.items.main_domain": "<string>",
  "tasks.result.items.url_rank": 123,
  "tasks.result.items.spam_score": "<string>",
  "tasks.result.items.domain_rank": "<string>",
  "tasks.result.items.fetch_time": "<string>",
  "tasks.result.items.country": "<string>",
  "tasks.result.items.language": "<string>",
  "tasks.result.items.score": "<string>",
  "tasks.result.items.page_category": [
    "<string>"
  ],
  "tasks.result.items.page_types": [
    "<string>"
  ],
  "tasks.result.items.ratings": [
    "<string>"
  ],
  "tasks.result.items.social_metrics": [
    "<string>"
  ],
  "tasks.result.items.content_info": {},
  "tasks.result.items.content_info.content_type": "<string>",
  "tasks.result.items.content_info.title": "<string>",
  "tasks.result.items.content_info.main_title": "<string>",
  "tasks.result.items.content_info.previous_title": "<string>",
  "tasks.result.items.content_info.level": 123,
  "tasks.result.items.content_info.author": "<string>",
  "tasks.result.items.content_info.snippet": "<string>",
  "tasks.result.items.content_info.snippet_length": 123,
  "tasks.result.items.content_info.social_metrics": [
    "<string>"
  ],
  "tasks.result.items.content_info.highlighted_text": "<string>",
  "tasks.result.items.content_info.language": "<string>",
  "tasks.result.items.content_info.sentiment_connotations": {},
  "tasks.result.items.content_info.connotation_types": {},
  "tasks.result.items.content_info.text_category": [
    "<string>"
  ],
  "tasks.result.items.content_info.date_published": "<string>",
  "tasks.result.items.content_info.content_quality_score": 123,
  "tasks.result.items.content_info.semantic_location": "<string>",
  "tasks.result.items.content_info.rating": {},
  "tasks.result.items.content_info.rating.name": "<string>",
  "tasks.result.items.content_info.rating.rating_value": 123,
  "tasks.result.items.content_info.rating.max_rating_value": 123,
  "tasks.result.items.content_info.rating.rating_count": 123,
  "tasks.result.items.content_info.rating.relative_rating": 123,
  "tasks.result.items.content_info.group_date": "<string>"
}

授权

​
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"

​
search_mode
string

结果分组类型。可选字段，可能的分组类型：as_is – 返回目标关键词的所有引用；one_per_domain – 每个域名返回一条该关键词的引用。默认值：as_is

​
limit
integer

返回引用的最大数量；可选字段；默认值：100；最大值：1000

​
filters
string[]

结果过滤参数数组，可选字段；您可以同时添加多个过滤器（最多 8 个过滤器）；应在条件之间设置逻辑运算符 and、or；支持以下运算符：regex, not_regex, , , >, >=, =, , in, not_in, like,not_like, match, not_match；您可以将 % 运算符与 like 和 not_like 一起使用，以匹配包含零个或多个字符的任意字符串；示例：["country","=", "US"] [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]] [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or", ["content_info.text_category","has",10994]]] 有关过滤器的更多信息，请参阅 Content Analysis API – Filters

​
order_by
string[]

结果排序规则 可选字段 可使用与 filters 数组中相同的值对结果进行排序 支持的排序类型：asc – 结果将按升序排列 desc – 结果将按降序排列 应使用逗号设置排序类型 示例：["content_info.sentiment_connotations.anger,desc"] 默认规则：["content_info.sentiment_connotations.anger,desc"] 请注意，单次请求最多可设置三条排序规则 应使用逗号分隔多条排序规则 示例：["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]

​
offset
integer

返回的引用结果数组中的偏移量；可选字段。默认值：0。如果指定值 10，results 数组中的前十条引用将被跳过，并提供后续引用的数据。注意：建议仅在检索不超过 10,000 条结果时使用此参数；如需检索超过 10,000 条结果，请改用 offset_token。

​
offset_token
string

用于后续请求的 offset token，可选字段。在每个请求响应的同名 field 中提供；尝试在单个请求中获取超过 10,000 条结果时，使用此参数可避免超时；通过指定响应数组中唯一的 offset_token 值，您将获得初始任务的后续结果；每个后续任务的 offset_token 值均唯一。注意：如果请求中指定了 offset_token，处理任务时将忽略除 limit 以外的所有其他参数。有关此参数的更多信息，请参阅我们的帮助中心。

​
rank_scale
string

定义用于计算和显示 domain_rank 与 url_rank 值的范围，可选字段。你可以使用此参数选择以 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.offset_token
string

用于后续请求的偏移令牌；您可以使用此字段中提供的字符串获取初始任务的后续结果；注意：每个后续任务的 offset_token 值都是唯一的

​
tasks.result.total_count
integer

数据库中与您的请求相关的结果总量

​
tasks.result.items_count
integer

items 数组中返回的结果数量

​
tasks.result.items
string[]

包含引用和相关数据

​
tasks.result.items.type
string

元素类型 = ‘content_analysis_search’

​
tasks.result.items.url
string

找到引用的 URL

​
tasks.result.items.domain
string

域名

​
tasks.result.items.main_domain
string

主域名

​
tasks.result.items.url_rank
integer

URL 的排名；此值基于 DataForSEO Backlink Index 中给定 URL 的反向链接数据；url_rank 根据关联数据库中的节点排名方法计算，该原理用于最初的 Google PageRank 算法；有关此指标及其计算方式的更多信息，请参阅此帮助中心文章

​
tasks.result.items.spam_score
string

该 URL 的反向链接垃圾评分。此值基于 DataForSEO Backlink Index 中给定 URL 的反向链接数据；有关该指标计算方式的更多信息，请参阅此帮助中心页面

​
tasks.result.items.domain_rank
string

域名排名 此值基于 DataForSEO Backlink Index 中给定域名的反向链接数据；domain_rank 采用链接数据库中的节点排名方法计算，该原理用于最初的 Google PageRank 算法；有关此指标及其计算方式的更多信息，请参阅此帮助中心文章

​
tasks.result.items.fetch_time
string

爬虫访问页面的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”，示例：2017-01-24 13:20:59 +00:00

​
tasks.result.items.country
string

域名注册国家/地区代码；如需获取可用国家/地区的完整列表，请参阅 Locations 端点

​
tasks.result.items.language
string

域名的主要语言；如需获取可用语言的完整列表，请参阅 Languages 端点

​
tasks.result.items.score
string

引用显著度评分。此值基于 url_rank、domain_rank，以及关键词在 title、main_title、url、snippet 中的出现情况。评分越高，相关引用的价值越大。

​
tasks.result.items.page_category
string[]

包含所有相关页面类别，即与该页面相关的产品和服务类别。要获取可用类别的完整列表，请参阅 Categories 端点

​
tasks.result.items.page_types
string[]

页面类型

​
tasks.result.items.ratings
string[]

页面上找到的评分，即基于微数据在页面上找到的所有评分

​
tasks.result.items.social_metrics
string[]

社交媒体互动指标，即与内容相关的社交媒体互动数据，基于由社交媒体平台开发并支持的网站嵌入功能

​
tasks.result.items.content_info
object

包含给定 URL 的引用数据

​
tasks.result.items.content_info.content_type
string

内容类型，例如：page_content、comment

​
tasks.result.items.content_info.title
string

结果标题

​
tasks.result.items.content_info.main_title
string

页面标题

​
tasks.result.items.content_info.previous_title
string

上一个内容块的标题

​
tasks.result.items.content_info.level
integer

标题层级表示 h 标签的级别，范围从 1（最高）到 6（最低）

​
tasks.result.items.content_info.author
string

内容作者

​
tasks.result.items.content_info.snippet
string

内容片段

​
tasks.result.items.content_info.snippet_length
integer

摘要的字符长度

​
tasks.result.items.content_info.social_metrics
string[]

社交媒体互动指标，即与内容相关的社交媒体互动数据，基于由社交媒体平台开发并支持的网站嵌入功能

​
tasks.result.items.content_info.highlighted_text
string

摘要中突出显示的文本

​
tasks.result.items.content_info.language
string

内容语言；如需获取所有可用语言的完整列表，请参阅 Languages 端点

​
tasks.result.items.content_info.sentiment_connotations
object

情感内涵，包含与给定引用相关的情感（情绪反应），以及每种情感对应的概率指数。可能的情感内涵：anger, happiness, love, sadness, share, fun

​
tasks.result.items.content_info.connotation_types
object

内涵类型 包含与给定引用相关的情感类型（情感极性），以及每种情感类型的概率指数 可能的情感内涵类型：positive、negative、neutral

​
tasks.result.items.content_info.text_category
string[]

文本类别；如需获取所有可用类别的完整列表，请参阅 Categories 端点

​
tasks.result.items.content_info.date_published
string

内容发布的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2017-01-24 13:20:59 +00:00

​
tasks.result.items.content_info.content_quality_score
integer

内容质量评分，此值根据内容包含的单词、句子和字符数量计算得出

​
tasks.result.items.content_info.semantic_location
string

semantic location 表示目标关键词引用所在的 HTML 语义元素，例如：article、header

​
tasks.result.items.content_info.rating
object

与 content_info 相关的内容分级

​
tasks.result.items.content_info.rating.name
string

评分名称，可包含以下元素：Max5、Percents、CustomMax

​
tasks.result.items.content_info.rating.rating_value
integer

评级值

​
tasks.result.items.content_info.rating.max_rating_value
integer

评分名称的最大值

​
tasks.result.items.content_info.rating.rating_count
integer

投票数

​
tasks.result.items.content_info.rating.relative_rating
number

相对评级

​
tasks.result.items.content_info.group_date
string

引用组日期和时间，表示内容发布日期，或我们的爬虫首次访问该页面的日期和时间；此字段可用于按日期对引用进行分组并展示引用趋势；日期和时间采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”，示例：2017-01-24 13:20:59 +00:00