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-03Ready 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_bodyGoogle Hotels Specific Parameters
#1: Query Parameter
Parameter
Type
Description
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
Parameter
Type
Description
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
Parameter
Type
Description
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