Google Hotels API
Effortlessly scrape hotel listings and pricing data from Google Hotels in real time, with location targeting and no captchas.
To enable this engine, set the engine=google_hotels
parameter.
The Google Hotels API is built to extract structured hotel data directly from Google’s hotel search results. Whether you're looking for availability, pricing, ratings, or location-specific listings, this engine returns a detailed JSON response that reflects real-time results. As with other engines, you only need to send a simple GET request including your query parameters, and the API will return the relevant data in a clean and accessible format.

Google Hotels API Integration Examples
We will use the following URL as an example for this request:
https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03
Ready to Use Google Hotels Scraping Scripts
curl --request GET --url "https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03"
const http = require("https");
const options = {
"method": "GET",
"hostname": "serpapi.webscrapingapi.com",
"port": null,
"path": "/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03",
"headers": {}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
import http.client
conn = http.client.HTTPSConnection("serpapi.webscrapingapi.com")
conn.request("GET", "/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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/ioutil"
)
func main() {
url := "https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.get("https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03").asString();
var client = new RestClient("https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://serpapi.webscrapingapi.com/v2?api_key=<YOUR_API_KEY>&engine=google_hotels&type=search&q=hotels+in+cancun&check_in_date=2025-08-01&check_out_date=2025-08-03")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
Google Hotels Specific Parameters
#1: Query Parameter
q
required
string
This parameter is required when type
parameter is set to search
.
The keywords used to search on Google Hotels.
pid
string
This parameter is required when type
parameter is set to place
.
The pid
value of the hotel. Can be found sending an API request using the type=search
parameter.
#2: Request Customization Parameters
type
required
string
The type of search. Possible values are search
(to look for hotels in a certain area) and place
(to search prices for a specific hotel).
check_in_date
required
string
The check-in date, must have the YYYY-MM-DD
format.
check_out_date
required
string
The check-in date, must have the YYYY-MM-DD
format.
occupancy
string
The number of guests that will occupy a room. Supported values are numbers (to describe the number of adults), or comma-separated numbers (to describe the number of adults and children, along with their age).
Examples:
occupancy=2
(default) means 2 adults
occupancy=1,2
means 1 adult and 1 child (2 years old)
occupancy=1,2,2
means 1 adult and 2 child (each 2 years old)
free_cancellation
string
Whether the offer has free cancellation. Can be 1
or 0
(default).
accomodation_type
string
This parameter is available only when type
parameter is set to search
.
The type of accomodation. Can be hotels
(default) or vacation_rentals
.
currency
string
The currency used to show the prices (3-letter code).
#3: Device and Geolocation Parameters
device
string
The device used for your Google Hotels search. Possible values are desktop
(default), mobile
and tablet
.
Response Example
{
"overview": {
"type": "hotels_selection",
"title": "hotels in cancun",
"requested": {
"start_date": "2025-08-01",
"end_date": "2025-08-03",
"occupancy": 2,
"number_of_adults": 2
},
"available": "unknown",
"currency": "USD",
"results_cnt": 5743
},
"organic": [
{
"link": "https://slshotels.com/cancun/?utm_source=google&utm_medium=organic&utm_campaign=gmb-website&utm_content=website_button",
"pid": "ChoIm4-rlpf6pYb2ARoNL2cvMTFmeTdmYnNjMBAB",
"title": "SLS Cancun",
"fid": "0x8f4c2eb65b26ce21:0xf60c97d172cac79b",
"coordinates": [
21.166852499999997,
-86.8039974
],
"rating": 4.3,
"reviews_cnt": 546,
"price": "$137",
"rank": 1,
"global_rank": 10
},
{
"link": "https://www.marriott.com/en-us/hotels/cunwo-the-westin-resort-and-spa-cancun/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChgI9qats-jtn9hFGgwvZy8xcHR3aGZyOXIQAQ",
"title": "The Westin Resort & Spa, Cancun",
"fid": "0x8f4c2b0d61aaaaab:0x45b07f6e866b5376",
"coordinates": [
21.039202400000004,
-86.7821664
],
"rating": 4.1,
"reviews_cnt": 3977,
"price": "$100",
"rank": 2,
"global_rank": 11
},
{
"link": "http://www.flamingocancun.com/?partner=5556&utm_source=google&utm_medium=gmb&utm_campaign=web_link",
"pid": "ChgI5dSbnITb4JCXARoLL2cvMXRjeXloMGoQAQ",
"title": "Hotel Flamingo All Inclusive",
"fid": "0x8f4c2b0d61aaaaab:0x972182d84386ea65",
"coordinates": [
21.1177805,
-86.7568675
],
"rating": 3.7,
"reviews_cnt": 7108,
"price": "$45",
"rank": 3,
"global_rank": 12
},
{
"link": "https://mayanmonkey.com/mayan-monkey-cancun",
"pid": "ChcIgMrrvqa52ecoGgsvZy8xdGQxZmdzdBAB",
"title": "Mayan Monkey Cancún",
"fid": "0x8f4c2899bf6bc08f:0x28cf65ca67dae500",
"coordinates": [
21.1300386,
-86.75037359999999
],
"rating": 4.5,
"reviews_cnt": 6976,
"price": "$56",
"rank": 4,
"global_rank": 13
},
{
"link": "https://aquamarinabeach.com/",
"pid": "ChcIouHT6PServtlGgsvZy8xdGdueThidBAB",
"title": "Aquamarina Beach Hotel Cancun",
"fid": "0x8f4c2b90293b64fd:0x65f6b8f74d14f0a2",
"coordinates": [
21.1467457,
-86.79075200000001
],
"rating": 4.1,
"reviews_cnt": 5773,
"price": "$84",
"rank": 5,
"global_rank": 14
},
{
"link": "https://www.vrbo.com/2814493?MDPCID=VRBO-META.HPA.WEB-ORGANIC.VR",
"pid": "ChoQjsyf87rposOPARoNL2cvMTF5ZmQ5N20yMRAC",
"title": "Stunning Lagoon view",
"coordinates": [
21.135156631469727,
-86.82826232910156
],
"rating": 5,
"reviews_cnt": 1,
"price": "$89",
"rank": 6,
"global_rank": 15
},
{
"link": "https://www.marriott.com/en-us/hotels/cunal-aloft-cancun/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChoI5rW-stui3eGIARoNL2cvMTFidzRyeGx5YxAB",
"title": "Aloft Cancun",
"fid": "0x85d1ff3470e0b03f:0x88c37515b64f9ae6",
"coordinates": [
21.135425700000003,
-86.7465546
],
"rating": 4,
"reviews_cnt": 2829,
"price": "$75",
"rank": 7,
"global_rank": 16
},
{
"link": "https://www.iberostar.com/en/hotels/cancun/iberostar-selection-cancun/?utm_source=gmb&utm_medium=organic&utm_campaign=IBSVOL_AME_SEOLOC_GMB_NA_EN_DOM_DOM_PUJ_CUN_PULL_NA_NA_NA_NA_NA",
"pid": "ChgItYK8mpWcstZXGgwvZy8xMmhubjMxYjQQAQ",
"title": "Iberostar Selection Cancún",
"fid": "0x8f4c285ffaa3a94d:0x57acc8e1534f0135",
"coordinates": [
21.0671078,
-86.7784818
],
"rating": 4.7,
"reviews_cnt": 28319,
"price": "$421",
"rank": 8,
"global_rank": 17
},
{
"link": "https://www.marriott.com/en-us/hotels/cunbr-renaissance-cancun-resort-and-marina/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChoIsM7FmvHug9vZARoNL2cvMTFnbnJ3cjFoOBAB",
"title": "Renaissance Cancun Resort & Marina",
"fid": "0x8f4c296bcaa30543:0xd9b60f7713516730",
"coordinates": [
21.161537,
-86.8068749
],
"rating": 4.6,
"reviews_cnt": 2499,
"price": "$151",
"rank": 9,
"global_rank": 18
},
{
"link": "https://www.cyancancun.com/",
"pid": "ChkI9_fb4f29_OEoGg0vZy8xMXE1ODBjOXE2EAE",
"title": "Hotel Cyan Resort & Spa",
"fid": "0x8f4e83966c52cc7d:0x28c3f1efdc36fbf7",
"coordinates": [
21.0468215,
-86.7827605
],
"rating": 3.2,
"reviews_cnt": 615,
"price": "$71",
"rank": 10,
"global_rank": 19
},
{
"link": "https://www.marriott.com/en-us/hotels/cunri-residence-inn-cancun-hotel-zone/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChoItMyQ59D7n6KSARoNL2cvMTFxcHo3NzY5YxAB",
"title": "Residence Inn Cancun Hotel Zone",
"fid": "0x8f4e82422cb32ed7:0x92447fdd0ce42634",
"coordinates": [
21.0369027,
-86.797131
],
"rating": 4.1,
"reviews_cnt": 1074,
"price": "$66",
"rank": 11,
"global_rank": 20
},
{
"link": "http://www.casatortugas.com/",
"pid": "ChkIl_HE8JC-hcUXGg0vZy8xMWZ4enNwNjhfEAE",
"title": "Casa Tortugas Boutique Hotel - A Hidden Gem",
"fid": "0x8f4c28c3aa8268b1:0x178a15f10e113897",
"coordinates": [
21.137659499999998,
-86.7693724
],
"rating": 4.6,
"reviews_cnt": 202,
"price": "$105",
"rank": 12,
"global_rank": 21
},
{
"link": "https://www.solymarcancun.com/",
"pid": "ChkI-_7GrsWSof1AGg0vZy8xMWJ0djY3d3QwEAE",
"title": "Solymar Cancun Beach Resort",
"fid": "0x8f4e827d441a8ab7:0x40fa849455d1bf7b",
"coordinates": [
21.0524625,
-86.781993
],
"rating": 3.8,
"reviews_cnt": 3821,
"price": "$70",
"rank": 13,
"global_rank": 22
},
{
"link": "https://www.caminoreal.com/realinn/real-inn-cancun",
"pid": "ChkI5e3LsObn9oZvGg0vZy8xMWI2eXRzanBmEAE",
"title": "Real Inn Cancún",
"fid": "0x8f4c28d972cf6cdb:0x6f0ddb3e6612f6e5",
"coordinates": [
21.14305,
-86.7780193
],
"rating": 4.1,
"reviews_cnt": 2813,
"price": "$60",
"rank": 14,
"global_rank": 23
},
{
"link": "https://cancun.leblancsparesorts.com/?utm_source=google&utm_medium=organic&utm_campaign=gbp_listing",
"pid": "ChgIuO6Vq97JwsaRARoLL2cvMXRkN2Q2NjAQAQ",
"title": "Le Blanc Spa Resort Cancun All Inclusive Adults Only",
"fid": "0x8f4c28909b7da88f:0x918d0a4de5657738",
"coordinates": [
21.1258612,
-86.7526041
],
"rating": 4.6,
"reviews_cnt": 2705,
"price": "$506",
"rank": 15,
"global_rank": 24
},
{
"link": "https://www.marriott.com/en-us/hotels/cunfp-four-points-cancun-centro/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChoIrJT6jsShz5HIARoNL2cvMTFiNzNxajVxNBAB",
"title": "Four Points by Sheraton Cancun Centro",
"fid": "0x8f4c2be759da0be5:0xc8233d0c41de8a2c",
"coordinates": [
21.1371701,
-86.8272743
],
"rating": 4.4,
"reviews_cnt": 1628,
"price": "$84",
"rank": 16,
"global_rank": 25
},
{
"link": "https://www.vrbo.com/4521348?MDPCID=VRBO-META.HPA.WEB-ORGANIC.VR",
"pid": "ChkQh4v76PGPyPMbGg0vZy8xMXljeWJnYzU3EAI",
"title": "New luxury condo, rooftop and pool.",
"coordinates": [
21.112953186035156,
-86.85657501220703
],
"price": "$54",
"rank": 17,
"global_rank": 26
},
{
"link": "https://lapalmabeachfronthotel.com/",
"pid": "ChgI96vK8476xzgaDS9nLzExZjN5NGhocXIQAQ",
"title": "La Palma Beachfront Hotel Self Check-in",
"fid": "0x8f4c28a229e29439:0x711fd0ee7295f7",
"coordinates": [
21.136718899999998,
-86.7466699
],
"rating": 4.1,
"reviews_cnt": 255,
"price": "$86",
"rank": 18,
"global_rank": 27
},
{
"link": "https://www.marriott.com/en-us/hotels/cunmx-marriott-cancun-an-all-inclusive-resort/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
"pid": "ChgIr8qCw8_Hrd60ARoLL2cvMXRram03cjAQAQ",
"title": "Marriott Cancun, An All-Inclusive Resort",
"fid": "0x8f4c2847ebdca3db:0xb4bcb63cf860a52f",
"coordinates": [
21.0861891,
-86.7713935
],
"rating": 4.6,
"reviews_cnt": 5870,
"price": "$476",
"rank": 19,
"global_rank": 28
},
{
"link": "https://www.vacasa.com/unit/30547?utm_source=google&utm_medium=bookingapi",
"pid": "ChoQ-9D1prr4ve2gARoNL2cvMTFrajVtbWRkcRAC",
"title": "Riva Puerto Cancun # 207, Halibut",
"coordinates": [
21.160825729370117,
-86.80608367919922
],
"rating": 4.8868423,
"reviews_cnt": 76,
"price": "$140",
"rank": 20,
"global_rank": 29
}
],
"sponsored": [
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABACGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YASACEgKuqvD_BwE&category=acrcp_v1_48&sig=AOD64_0IXy_Ta7gQWN3i2vScBJvCR_Aq_Q&adurl=",
"pid": "CgoI9qats-jtn9hFEAE",
"title": "The Westin Resort & Spa, Cancun",
"coordinates": [
21.039202000000003,
-86.78216599999999
],
"rating": 4.1,
"reviews_cnt": 3977,
"price": "$104",
"rank": 1,
"global_rank": 1
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAFGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YAiACEgJQHfD_BwE&category=acrcp_v1_48&sig=AOD64_2vAa4LkhdXYG51KV5kZxOWgk9fVw&adurl=",
"pid": "CgsI5rW-stui3eGIARAB",
"title": "Aloft Cancun",
"coordinates": [
21.135426000000002,
-86.746555
],
"rating": 4,
"reviews_cnt": 2829,
"price": "$108",
"rank": 2,
"global_rank": 2
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAIGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YAyACEgJZUvD_BwE&category=acrcp_v1_48&sig=AOD64_1wKRTL06xe_wCQ4w8Uh5S8PsKSQQ&adurl=",
"pid": "CgoI8P3mqdPf8KkyEAE",
"title": "Secrets The Vine Cancun",
"coordinates": [
21.090540999999998,
-86.77011
],
"rating": 4.5,
"reviews_cnt": 7195,
"price": "$527",
"rank": 3,
"global_rank": 3
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABALGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YBCACEgJgBvD_BwE&category=acrcp_v1_48&sig=AOD64_2IDZUb1iI7Zjjpp9G05I9A0VU9EA&adurl=",
"pid": "CgoI7bfGv8vWlOoHEAE",
"title": "Hilton Cancun, an All-Inclusive Resort",
"coordinates": [
20.95382,
-86.836112
],
"rating": 4.5,
"reviews_cnt": 7170,
"price": "$366",
"rank": 4,
"global_rank": 4
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAOGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YBSACEgL3BvD_BwE&category=acrcp_v1_48&sig=AOD64_1hdB6N8hgJMgnvjsC0uAbDR3SKpA&adurl=",
"pid": "CgoIxvrX2NKvnP8fEAE",
"title": "Hotel Calypso Cancun",
"coordinates": [
21.143888,
-86.78999
],
"rating": 4,
"reviews_cnt": 1870,
"price": "$62",
"rank": 5,
"global_rank": 5
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABARGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YBiACEgLDTPD_BwE&category=acrcp_v1_48&sig=AOD64_08yUlbof_JYj41yLhA_RuSP-_tUg&adurl=",
"pid": "CgoIsY7q-pbRzYhWEAE",
"title": "Suites Malecon Cancun",
"coordinates": [
21.148312,
-86.821968
],
"rating": 4.1,
"reviews_cnt": 1099,
"price": "$54",
"rank": 6,
"global_rank": 6
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAUGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YByACEgJjHfD_BwE&category=acrcp_v1_48&sig=AOD64_3dcceOoNAJ9fpCdrkFqdfO1YLWQA&adurl=",
"pid": "CgoI1d-OjND_gpNgEAE",
"title": "Hilton Cancun Mar Caribe All-Inclusive Resort",
"coordinates": [
21.071960999999998,
-86.776721
],
"rating": 4.2,
"reviews_cnt": 1399,
"price": "$421",
"rank": 7,
"global_rank": 7
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAXGgJsZQ&ae=2&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YCCACEgJxgPD_BwE&category=acrcp_v1_50&sig=AOD64_3l2zFBEJutIfPMvum1zbqqK-IrIQ&adurl=",
"pid": "CgoIqsPo8_7jgapXEAE",
"title": "Hyatt Ziva Cancun",
"coordinates": [
21.135507999999998,
-86.742308
],
"rating": 4.5,
"reviews_cnt": 7174,
"price": "$802",
"rank": 8,
"global_rank": 8
},
{
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiqsfeazLKOAxW_F6IDHT0VLBwYABAaGgJsZQ&co=1&ase=2&gclid=EAIaIQobChMIqrH3msyyjgMVvxeiAx09FSwcEA0YCSACEgL0GvD_BwE&category=acrcp_v1_48&sig=AOD64_3ctNSETdC9ShB2YriSv-Eyhr9mWA&adurl=",
"pid": "CgoIrbCE8YzG1MYpEAE",
"title": "InterContinental Presidente Cancun Resort by IHG",
"coordinates": [
21.135453,
-86.75435600000002
],
"rating": 4.5,
"reviews_cnt": 3511,
"price": "$269",
"rank": 9,
"global_rank": 9
}
]
}
Last updated