设置 Business Data Tripadvisor Reviews 任务

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url_path": "<string>",
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "priority": 123,
  "language_name": "<string>",
  "language_code": "<string>",
  "depth": 123,
  "ratings": [
    "<string>"
  ],
  "visit_type": [
    "<string>"
  ],
  "months": [
    "<string>"
  ],
  "search_reviews_keyword": "<string>",
  "sort_by": "<string>",
  "translate_reviews": true,
  "tag": "<string>",
  "postback_url": "<string>",
  "pingback_url": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post"

payload = {
    "url_path": "<string>",
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "priority": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "depth": 123,
    "ratings": ["<string>"],
    "visit_type": ["<string>"],
    "months": ["<string>"],
    "search_reviews_keyword": "<string>",
    "sort_by": "<string>",
    "translate_reviews": True,
    "tag": "<string>",
    "postback_url": "<string>",
    "pingback_url": "<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({
    url_path: '<string>',
    keyword: '<string>',
    location_name: '<string>',
    location_code: 123,
    priority: 123,
    language_name: '<string>',
    language_code: '<string>',
    depth: 123,
    ratings: ['<string>'],
    visit_type: ['<string>'],
    months: ['<string>'],
    search_reviews_keyword: '<string>',
    sort_by: '<string>',
    translate_reviews: true,
    tag: '<string>',
    postback_url: '<string>',
    pingback_url: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post', 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/business_data/tripadvisor/reviews/task_post",
  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([
    'url_path' => '<string>',
    'keyword' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'priority' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'depth' => 123,
    'ratings' => [
        '<string>'
    ],
    'visit_type' => [
        '<string>'
    ],
    'months' => [
        '<string>'
    ],
    'search_reviews_keyword' => '<string>',
    'sort_by' => '<string>',
    'translate_reviews' => true,
    'tag' => '<string>',
    'postback_url' => '<string>',
    'pingback_url' => '<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/business_data/tripadvisor/reviews/task_post"

	payload := strings.NewReader("{\n  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<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/business_data/tripadvisor/reviews/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post")

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  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\"\n}"

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

{
  "version": "<string>",
  "version.status_code": 123,
  "version.status_message": "<string>",
  "version.time": "<string>",
  "version.cost": 123,
  "version.tasks_count": 123,
  "version.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": {},
  "result": [
    "<string>"
  ]
}

POST

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

dataforseo

business_data

tripadvisor

reviews

task_post

设置 Business Data Tripadvisor Reviews 任务

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url_path": "<string>",
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "priority": 123,
  "language_name": "<string>",
  "language_code": "<string>",
  "depth": 123,
  "ratings": [
    "<string>"
  ],
  "visit_type": [
    "<string>"
  ],
  "months": [
    "<string>"
  ],
  "search_reviews_keyword": "<string>",
  "sort_by": "<string>",
  "translate_reviews": true,
  "tag": "<string>",
  "postback_url": "<string>",
  "pingback_url": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post"

payload = {
    "url_path": "<string>",
    "keyword": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "priority": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "depth": 123,
    "ratings": ["<string>"],
    "visit_type": ["<string>"],
    "months": ["<string>"],
    "search_reviews_keyword": "<string>",
    "sort_by": "<string>",
    "translate_reviews": True,
    "tag": "<string>",
    "postback_url": "<string>",
    "pingback_url": "<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({
    url_path: '<string>',
    keyword: '<string>',
    location_name: '<string>',
    location_code: 123,
    priority: 123,
    language_name: '<string>',
    language_code: '<string>',
    depth: 123,
    ratings: ['<string>'],
    visit_type: ['<string>'],
    months: ['<string>'],
    search_reviews_keyword: '<string>',
    sort_by: '<string>',
    translate_reviews: true,
    tag: '<string>',
    postback_url: '<string>',
    pingback_url: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post', 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/business_data/tripadvisor/reviews/task_post",
  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([
    'url_path' => '<string>',
    'keyword' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'priority' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'depth' => 123,
    'ratings' => [
        '<string>'
    ],
    'visit_type' => [
        '<string>'
    ],
    'months' => [
        '<string>'
    ],
    'search_reviews_keyword' => '<string>',
    'sort_by' => '<string>',
    'translate_reviews' => true,
    'tag' => '<string>',
    'postback_url' => '<string>',
    'pingback_url' => '<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/business_data/tripadvisor/reviews/task_post"

	payload := strings.NewReader("{\n  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<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/business_data/tripadvisor/reviews/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post")

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  \"url_path\": \"<string>\",\n  \"keyword\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"priority\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"depth\": 123,\n  \"ratings\": [\n    \"<string>\"\n  ],\n  \"visit_type\": [\n    \"<string>\"\n  ],\n  \"months\": [\n    \"<string>\"\n  ],\n  \"search_reviews_keyword\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"translate_reviews\": true,\n  \"tag\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\"\n}"

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

{
  "version": "<string>",
  "version.status_code": 123,
  "version.status_message": "<string>",
  "version.time": "<string>",
  "version.cost": 123,
  "version.tasks_count": 123,
  "version.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": {},
  "result": [
    "<string>"
  ]
}

此端点提供 Tripadvisor 平台上“评论”元素的结果。结果与您指定的 URL 路径或关键词以及所选位置相关（请参阅位置列表）。

示例

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"url_path": "...", "keyword": "...", "location_name": "..."}]'

授权

Authorization

string

header

必填

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

请求体

application/json

url_path

string

必填

商业实体的 URL 路径 如果未指定 keyword，则为必填字段商业实体 Tripadvisor 页面的 URL 路径；示例：Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

keyword

string

必填

keyword 如果未指定 url_path，则为必填字段。指定的关键词应表示 Tripadvisor 上现有商家或知名地点的名称；keyword 字段最多可指定 700 个字符；所有 %## 都将被解码（加号字符 ‘+’ 将被解码为空格字符）；如果需要在 keyword 中使用 “%” 字符，请将其指定为 “%25”

location_name

string

必填

搜索引擎位置的完整名称 如果未指定 location_code 或 url_path，则为必填字段；您可以通过向 https://api.dataforseo.com/v3/business_data/tripadvisor/locations 单独发送请求，获取包含 location_name 的可用位置列表；示例：London,England,United Kingdom

location_code

integer

必填

搜索引擎位置代码 如果未指定 location_name 或 url_path，则此字段为必填字段。可以通过向 https://api.dataforseo.com/v3/business_data/tripadvisor/locations 单独发起请求，获取包含 location_code 的可用位置列表。示例：1003854

priority

integer

任务优先级，可选字段，可取以下值：1 – 普通执行优先级（默认设置）；2 – 高执行优先级。高执行优先级的任务将收取额外费用。费用可在定价页面计算。

language_name

string

搜索引擎语言的完整名称，可选字段。如果使用此字段，将从您的账户中额外收取一次请求的费用。可以通过向 https://api.dataforseo.com/v3/business_data/tripadvisor/languages 单独发起请求，获取包含 language_name 的可用语言列表。示例：English。在此端点中设置语言参数将产生额外费用。费用可在定价页面计算。

language_code

string

搜索引擎语言代码 可选字段如果使用此字段，你的账户将被额外收取一次请求费用可以通过单独请求 https://api.dataforseo.com/v3/business_data/tripadvisor/languages 获取可用的 language_code 列表示例：en 在此端点中设置语言参数将产生额外费用。费用可在 Pricing 页面计算。

depth

integer

解析深度，可选字段。SERP 中的评论数量；强烈建议将解析深度设置为 10 的倍数，因为我们的系统每次处理 10 条评论；默认值：10；最大值：4490。每个包含最多 10 条结果的 SERP 都将计费；如果搜索引擎返回超过 10 条结果，将深度设置为 10 以上可能产生额外费用。费用可在定价页面计算。

ratings

string[]

Tripadvisor 上某个景点的旅行者评分 可选字段基于旅行者游览某个地点后撰写的评论得出的评分。可能的值：excellent、very_good、average、poor、terrible 可同时指定多个值

visit_type

string[]

按留下评论的旅客类型筛选 可选字段。可选值：families、couples、solo、business、friends。可同时指定多个值

months

string[]

按旅行者到访的月份筛选 可选字段，可选值：january、february、march、april、may、april、june、july、august、september、october、november、december；可同时指定多个值

search_reviews_keyword

string

搜索包含指定关键词的评价 示例：dessert

sort_by

string

结果排序参数 可选字段，可使用此字段对结果进行排序；支持的排序类型：most_recent detailed_reviews

translate_reviews

boolean

根据 URL 路径翻译评论 可选字段如果设置为 true，返回的评论将被翻译为与指定 url_path 匹配的语言；例如，如果 url_path 包含 tripadvisor.it 且 translate_reviews 为 true，评论将被翻译为意大利语；默认值：true 有关评论翻译方式的更多信息，请参阅此帮助中心文章

tag

string

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

postback_url

string

用于发送任务结果的返回 URL，可选字段。任务完成后，我们会向您指定的 postback_url 发送 POST 请求，结果将以 gzip 格式压缩。您可以将字符串 ‘$id’ 用作 $id 变量，并将 ‘$tag’ 用作经过 URL 编码的 $tag 变量。我们将在发送请求前设置必要的值。示例：http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意：postback_url 中的特殊字符将经过 URL 编码；例如，# 字符将编码为 %23。有关更多信息，请参阅我们的帮助中心

pingback_url

string

任务完成通知 URL，可选字段。任务完成后，我们将向你指定的 URL 发送 GET 请求以通知你。你可以使用字符串 ‘$id’ 作为 $id 变量，并使用 ‘$tag’ 作为经过 URL 编码的 $tag 变量。我们会在发送请求前设置必要的值。示例：http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意：pingback_url 中的特殊字符将进行 URL 编码；例如，# 字符将被编码为 %23。请访问我们的帮助中心了解更多信息。

响应

成功响应

version

string

API 的当前版本

version.status_code

integer

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

version.status_message

string

一般信息消息 你可以在此处查看一般信息消息的完整列表

version.time

string

执行时间（秒）

version.cost

number

任务总成本（美元）

version.tasks_count

integer

tasks数组中的任务数量

version.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

result 数组中的元素数量

tasks.path

string[]

URL 路径

tasks.data

object

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

result

string[]

结果数组；在这种情况下，该值将为 null

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

设置 Business Data Tripadvisor Reviews 任务

示例

授权

请求体

响应

​示例

授权

请求体

响应

示例