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))
}

回應

正在載入最新回應範例...