跳转到主要内容
GET
https://api.aisa.one/apis/v1
/
dataforseo
/
business_data
/
google
/
hotel_info
/
task_get
/
advanced
/
{id}
按 id 获取高级 Google 酒店信息结果
curl --request GET \
  --url https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id} \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}', 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/google/hotel_info/task_get/advanced/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

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

curl_close($curl);

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

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

func main() {

url := "https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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>"
  ],
  "result.hotel_identifier": "<string>",
  "result.location_code": 123,
  "result.language_code": "<string>",
  "result.check_url": "<string>",
  "result.datetime": "<string>",
  "result.title": "<string>",
  "result.stars": 123,
  "result.stars_description": "<string>",
  "result.address": "<string>",
  "result.phone": "<string>",
  "result.about": {},
  "result.description": "<string>",
  "result.sub_descriptions": [
    "<string>"
  ],
  "result.check_in_time": {},
  "result.hour": 123,
  "result.minute": 123,
  "result.check_out_time": {},
  "result.full_address": "<string>",
  "result.domain": "<string>",
  "result.url": "<string>",
  "result.amenities": [
    "<string>"
  ],
  "result.category": "<string>",
  "result.category_label": "<string>",
  "result.items": [
    "<string>"
  ],
  "result.amenity": "<string>",
  "result.amenity_label": "<string>",
  "result.hint": "<string>",
  "result.hint_label": "<string>",
  "result.is_available": true,
  "result.popular_amenities": [
    "<string>"
  ],
  "result.location": {},
  "result.neighborhood": "<string>",
  "result.neighborhood_description": "<string>",
  "result.maps_url": "<string>",
  "result.overall_score": 123,
  "result.score_by_categories": {},
  "result.overall": 123,
  "result.things_to_do": 123,
  "result.restaurants": 123,
  "result.transit": 123,
  "result.airport_access": 123,
  "result.latitude": 123,
  "result.longitude": 123,
  "result.location_chain": [
    "<string>"
  ],
  "result.card_id": "<string>",
  "result.feature_id": "<string>",
  "result.cid": "<string>",
  "result.reviews": {},
  "result.value": 123,
  "result.votes_count": 123,
  "result.mentions": [
    "<string>"
  ],
  "result.positive_score": 123,
  "result.positive_count": 123,
  "result.negative_count": 123,
  "result.total_count": 123,
  "result.visible_by_default": true,
  "result.rating_distribution": {},
  "result.5": 123,
  "result.4": 123,
  "result.3": 123,
  "result.2": 123,
  "result.1": 123,
  "result.other_sites_reviews": [
    "<string>"
  ],
  "result.review_text": "<string>",
  "result.rating": {},
  "result.rating_type": "<string>",
  "result.rating_max": 123,
  "result.overview_images": [
    "<string>"
  ],
  "result.prices": {},
  "result.price": 123,
  "result.price_without_discount": 123,
  "result.currency": "<string>",
  "result.discount_text": "<string>",
  "result.check_in": "<string>",
  "result.check_out": "<string>",
  "result.visitors": 123,
  "result.type": "<string>",
  "result.is_paid": true,
  "result.free_cancellation_until": "<string>",
  "result.offers": [
    "<string>"
  ],
  "result.max_visitors": 123,
  "result.offer_images": [
    "<string>"
  ],
  "result.prices_by_dates": [
    "<string>"
  ],
  "result.check_in_date": "<string>",
  "result.check_out_date": "<string>"
}

授权

Authorization
string
header
必填

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

路径参数

id
string
必填

DataForSEO 任务 ID。

查询参数

id
string

任务标识符 本系统中采用 UUID 格式的唯一任务标识符;你可以在 30 天内随时使用它请求任务结果。

响应

成功响应

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[]

结果数组

result.hotel_identifier
string

唯一酒店标识符 此字段将包含 hotel_identifier 参数;示例:CgoI-KWyzenM_MV3EAE

result.location_code
integer

POST 数组中的位置代码

result.language_code
string

POST 数组中的语言代码

result.check_url
string

搜索引擎结果的直接 URL,你可以使用它确认我们提供的结果是否准确

result.datetime
string

收到结果的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

result.title
string

报价标题

result.stars
integer

酒店星级 介于 1 至 5 星之间,显示在酒店摘要中的评论评分之后

result.stars_description
string

酒店星级 介于 1 至 5 星之间的星级,显示在酒店摘要中的评价评分之后

result.address
string

酒店地址 酒店的实际地址

result.phone
string

酒店电话号码 酒店的联系电话

result.about
object

酒店信息

result.description
string

酒店描述 收集结果所对应酒店实体的描述

result.sub_descriptions
string[]

酒店的附加描述 除酒店描述外提供的酒店详细信息

result.check_in_time
object

酒店入住时间 酒店列表中标示的入住时间

result.hour
integer

退房时间

result.minute
integer

退房分钟

result.check_out_time
object

酒店退房时间 酒店信息中标示的退房时间

result.full_address
string

酒店完整地址 以标准化格式表示的酒店地址

result.domain
string

第三方域名 提供定价信息的第三方网站页面的域名

result.url
string

价格优惠的 url 显示价格优惠的网站页面 URL

result.amenities
string[]

酒店设施 酒店设施相关信息

result.category
string

标准化设施类别

result.category_label
string

类别标签

result.items
string[]

项目数组 包含第三方网站定价详情的数组;可能的项目类型:hotel_info_price

result.amenity
string

标准化设施名称

result.amenity_label
string

显示的便利设施名称

result.hint
string

关于便利设施的标准化详细信息

result.hint_label
string

显示的设施详情

result.is_available
boolean

表示酒店是否提供 amenity

酒店设施 被标记为“热门”的酒店设施信息

result.location
object

酒店位置信息 有关酒店所在地理位置的信息

result.neighborhood
string

酒店所在街区的名称

result.neighborhood_description
string

酒店所在街区的描述

result.maps_url
string

酒店在 Google 地图中的位置 URL

result.overall_score
number

酒店位置综合评分;表示酒店位置的综合评分,范围为 1 到 5;根据酒店与附近活动场所和餐厅、交通设施及机场的距离数据计算;请注意,各项标准在综合评分中的权重并不相同

result.score_by_categories
object

酒店位置的类别评分 与酒店位置相关的评分,其类别用于表示与附近游乐活动、餐厅、交通设施和机场的距离;

result.overall
number

酒店位置综合评分;表示酒店位置的综合评分,范围为 1 到 5;根据酒店与附近活动场所和餐厅、交通设施及机场的距离数据计算;请注意,各项标准在综合评分中的权重并不相同

result.things_to_do
number

相对于附近休闲活动的评分 表示酒店位置的评分,范围为 1 到 5;根据酒店与附近休闲活动地点的距离数据计算得出

result.restaurants
number

相对于附近餐厅的评分 表示酒店位置的评分,范围为 1 到 5;根据酒店与附近餐厅的距离数据计算得出

result.transit
number

相对于附近交通选项的评分表示酒店位置的评分,范围为 1 到 5;根据酒店与附近交通选项的距离数据计算得出

result.airport_access
number

相对于附近机场的评分 表示酒店位置的评分,范围为 1 到 5;根据酒店与附近机场的距离数据计算得出。

result.latitude
number

酒店纬度 酒店所在位置的纬度坐标,示例:39.4806397

result.longitude
number

酒店经度 酒店所在位置的纬度坐标,示例:-106.0512973

result.location_chain
string[]

位置链中的元素 位置链中每个元素的附加参数

result.card_id
string

卡片标识符

result.feature_id
string

功能标识符;有关该标识符的更多信息,请参阅此帮助中心文章

result.cid
string

client id;有关此标识符的更多信息,请参阅此帮助中心文章

result.reviews
object

按条件分类的酒店评论,有关酒店实体评论的信息

result.value
number

rating value 评论中所含评分的值,可选值:CustomMax – 1 到 10 范围内的值;Max5 – 1 到 5 范围内的值

result.votes_count
integer

投票数 评论中包含的投票数量

result.mentions
string[]

酒店提及 按条件分类的酒店评论信息

result.positive_score
number

按标准计算的正向评分

result.positive_count
integer

按标准统计的正面评价数量

result.negative_count
integer

按标准统计的负面评论数量

result.total_count
integer

按标准统计的所有评论数量

result.visible_by_default
boolean

元素默认可见 表示评论元素默认是否可见

result.rating_distribution
object

按投票数划分的评分分布,投票在 1 至 5 分范围内各评分中的分布

result.5
integer

对五星评分的投票数

result.4
integer

对 4 分评级的投票数

result.3
integer

对 3 分评级的投票数

result.2
integer

对 2 分评级的投票数

result.1
integer

1 分评分的投票数

result.other_sites_reviews
string[]

第三方网站上的评论 来自第三方网站的评论

result.review_text
string

评论文本 评论的文本

result.rating
object

评论中的评分 有关第三方网站评论中所含评分的信息

result.rating_type
string

评分类型 评论中包含的评分类型,可选值:CustomMaxMax5

result.rating_max
integer

评分最大值 rating_type 的最大值

result.overview_images
string[]

酒店概览中显示的图片 包含酒店概览中显示的图片 URL 的数组

result.prices
object

酒店实体的定价详情 包含酒店价格信息

result.price
integer

每晚价格 在特定日期入住酒店的每晚价格

result.price_without_discount
integer

未折扣价格 未应用任何折扣时的酒店每晚住宿价格

result.currency
string

价格币种示例:USD

result.discount_text
string

折扣文本

result.check_in
string

入住日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00

result.check_out
string

UTC 格式的退房日期和时间:“yyyy-mm-dd hh-mm-ss +00:00”,示例:2019-11-15 12:57:46 +00:00

result.visitors
integer

访客数量

result.type
string

type = ‘hotel_info_price_offer’

result.is_paid
boolean

指示是否为付费预订链接 如果为 true,相关 hotel_info_price 项为酒店广告;如果为 false,相关 hotel_info_price 项为免费预订链接

result.free_cancellation_until
string

可免费取消的截止日期,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;如果所选日期不支持免费取消,则等于 null

result.offers
string[]

特色价格优惠

result.max_visitors
integer

访客人数上限,价格优惠适用的最大访客人数

result.offer_images
string[]

报价图片 报价中展示的图片 URL

result.prices_by_dates
string[]

按日期列出的酒店住宿价格对象数组

result.check_in_date
string

入住日期,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”,示例:2025-05-20 12:00:00 +00:00

result.check_out_date
string

退房日期,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00” 示例:2025-05-21 12:00:00 +00:00