Google Hotels 搜索 API

prod-global

GET

/api/v1/google/hotels/search

API 健康状态

健康 可用 受限 大多不可用 无数据

正在加载健康状态...

获取 Google 酒店搜索数据，包括价格、评分和可用性详情，用于旅行比较和酒店市场分析。

标签: Google Hotels

请求参数

名称	必填	类型	默认值	说明
query	是	string		您正在搜索的目的地或具体酒店名称（例如'巴黎'、'纽约希尔顿酒店'）。
check_in_date	是	string		酒店入住日期，格式为'YYYY-MM-DD'（例如'2026-05-20'）。
check_out_date	是	string		酒店退房日期，格式为'YYYY-MM-DD'（例如'2026-05-25'）。
next_page_token	否	string		用于获取下一页酒店结果的令牌。该令牌位于先前响应的'next_page_token'字段中。
adults	否	integer	2	入住房间的成人数量。
children	否	integer	0	入住房间的儿童数量。
children_ages	否	string		儿童的年龄，用逗号分隔（例如'5,10'）。年龄数量必须与'children'参数匹配。
html	否	boolean	false	设置为 true 以返回 Google 搜索结果页面的原始 HTML 以及结构化数据。
language	否	string	en	使用其两位字母代码设置结果语言（例如 'en' 表示英语，'fr' 表示法语）。请参阅 Google 语言。
country	否	string	us	设置目标国家代码（例如 'us'、'uk'）以本地化结果。请参阅 Google 国家/地区。
currency	否	string	USD	用于显示价格的三字母ISO货币代码（例如'USD'、'EUR'）。请参阅Google Hotels 货币。
sort_by	否	string		酒店结果的排序标准。 可用值： - LOWEST_PRICE：最低价格。也接受旧值 3。 - HIGHEST_RATING：最高评分。也接受旧值 8。 - MOST_REVIEWS：最多评论。也接受旧值 13。
min_price	否	string		酒店住宿的最低价格筛选。
max_price	否	string		酒店住宿的最高价格筛选。
property_types	否	string		按酒店物业类型筛选。请参阅Google 物业类型获取支持的酒店物业类型完整列表。对于度假租赁，请参阅Google Hotels 度假租赁物业类型。
amenities	否	string		按特定设施筛选（例如'35'表示免费Wi-Fi）。Google Hotels 设施（酒店设施）。Google Hotels 度假租赁设施（度假租赁设施）
rating	否	string		按最低住客评分筛选。 可用值： - AT_LEAST_3_5：3.5+住客评分。也接受旧值 7。 - AT_LEAST_4_0：4.0+住客评分。也接受旧值 8。 - AT_LEAST_4_5：4.5+住客评分。也接受旧值 9。
brands	否	string		按特定酒店品牌ID筛选。ID可以用逗号分隔。
hotel_class	否	string		按酒店星级评分筛选。支持的值：'2'、'3'、'4'、'5'。可用逗号分隔。
free_cancellation	否	string		筛选提供免费取消的酒店。设置为 '1' 或 'true' 以启用。
special_offers	否	string		筛选当前提供特惠或折扣的酒店。设置为 '1' 或 'true' 以启用。
eco_certified	否	string		筛选获得生态认证的酒店。设置为 '1' 或 'true' 以启用。
vacation_rentals	否	boolean	false	设置为 true 以搜索度假租赁而非标准酒店。
bedrooms	否	string		所需的最少卧室数量（适用于度假租赁）。
bathrooms	否	string		所需的最少浴室数量（适用于度假租赁）。
property_token	否	string		用于获取特定酒店物业详细信息的唯一令牌。

复制请求

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/hotels/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee",
  "check_in_date": "YOUR_VALUE",
  "check_out_date": "YOUR_VALUE"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

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

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

响应

正在加载最新响应示例...