Travel: Hotels

Scrape Google Travel: Hotels results with guest count, dates, and star rating filters. Flexible API integration with comprehensive parameter options.

The google_travel_hotels data source is designed to retrieve Google Travel service's hotel search results.

To ensure optimal utilization of this service, include the "render": "html" parameter in your request.

Request samples

In this example, we make a request to retrieve the 2nd results page for hotel availability for 2 adult guests between 2023-10-01 and 2023-10-10 for 2 to 4-star hotels in Paris from google.com.

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_travel_hotels",
        "start_page": 2,
        "query": "hotels in Paris",
        "render": "html",
        "parse": true,
        "context": [
            {"key": "adults", "value": 2},
            {"key": "hotel_dates", "value": "2023-10-01,2023-10-10"},
            {"key": "hotel_classes", "value": [2, 3, 4]}
        ]
    }'

Python

import requests
from pprint import pprint

# Structure payload.
payload = {
  "source": "google_travel_hotels",
  "query": "hotels in Paris",
  "start_page": 2,
  "render": "html",
  "parse": True,
  "context": [
    {
      "key": "adults",
      "value": 1
    },
    {
      "key": "hotel_dates",
      "value": "2023-10-01,2023-10-10"
    },
    {
      "key": "hotel_classes",
      "value": [2, 3, 4]
    }
  ]
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_travel_hotels",
    start_page: 2,
    query: "hotels in Paris",
    render: "html",
    parse: true,
    context: [
        { key: "adults", value: 2 },
        { key: "hotel_dates", value: "2023-10-01,2023-10-10" },
        { key: "hotel_classes", value: [2, 3, 4] },
    ],
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

HTTP

https://realtime.oxylabs.io/v1/queries?source=google_travel_hotels&query=hotels+in+Paris&start_page=3&render=html&parse=true&context[0][key]=adults&context[0][value]=1&context[1][key]=hotel_dates&context[1][value]=2023-10-01,2023-10-10&context[2][key]=hotel_classes&context[2][value]=[2,3,4]&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'google_travel_hotels',
    'start_page' => 2,
    'query' => 'hotels in Paris',
    'render' => 'html',
    'parse' => true,
    'context' => [
        ['key' => 'adults', 'value' => 2],
        ['key' => 'hotel_dates', 'value' => '2023-10-01,2023-10-10'],
        ['key' => 'hotel_classes', 'value' => [2, 3, 4]]
    ]
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Golang

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":     "google_travel_hotels",
		"start_page": 2,
		"query":      "hotels in Paris",
		"render":     "html",
		"parse":			true,
		"context": []map[string]interface{}{
			{"key": "adults", "value": 2},
			{"key": "hotel_dates", "value": "2023-10-01,2023-10-10"},
			{"key": "hotel_classes", "value": []interface{}{2, 3, 4}},
		},
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "google_travel_hotels",
                start_page = 2,
                query = "hotels in Paris",
                render = "html",
                parse = true,
                context = new dynamic [] {
                    new { key = "adults", value = 2 },
                    new { key = "hotel_dates", value = "2023-10-01,2023-10-10" },
                    new { key = "hotel_classes", value = new int [] {2, 3, 4} }
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_travel_hotels");
        jsonObject.put("start_page", 2);
        jsonObject.put("query", "hotels in Paris");
        jsonObject.put("render", "html");
        jsonObject.put("parse", true);
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject().put("key", "adults").put("value", 2))
                .put(new JSONObject().put("key", "hotel_dates").put("value", "2023-10-01,2023-10-10"))
                .put(new JSONObject().put("key", "hotel_classes").put("value", new JSONArray().put(2).put(3).put(4)))
        );

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

JSON

{
    "source": "google_travel_hotels",
    "start_page": 2, 
    "query": "hotels in Paris",
    "render": "html", 
    "parse": true,
    "context": [
        {
            "key": "adults", 
            "value": 2
        }, 
        {
            "key": "hotel_dates", 
            "value": "2023-10-01,2023-10-10"
        },
        {
            "key": "hotel_classes", 
            "value": [2,3,4]
        }
    ]
}

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameters

Generic

Parameter	Description	Default Value
source	Sets the scraper. Use google_travel_hotels.	–
query	Search term for request. "query": "hotels" will return a list of hotels in a given geo_location. "query": "hotels in <Location>" will return a list of hotels for <Location>. (e.g. "query": "hotels in Paris" will list hotels in Paris, regardless of geo_location)	–
render	Enables JavaScript rendering when set to html. More info.	–
parse	Returns parsed data when set to true. See more in output dictionary.	false
callback_url	URL to your callback endpoint. More info.	–
user_agent_type	Device type and browser. The full list can be found here.	desktop

- mandatory parameter

Localization

Adapt search results to specific geographical locations and languages.

Parameter	Description	Default Value
geo_location	The geographical location that the result should be adapted for. Using this parameter correctly is extremely important to get the right data. Please note that this source can accept a limited number of geo_location values - please check this section to see geo_location values that don't yield accurate results.	-
locale	Accept-Language header value which changes your Google search page web interface language. More info.	-

NOTE: "geo_location": "United States" and other wide-area locations are not supported. Use city-level geo_location, e.g., Seattle,Washington,United States

Pagination

Parameter	Description	Default Value
start_page	Starting page number.	1

Filtering

Advanced options for tailoring and refining the search context.

Parameter	Description	Default Value
context:adults	Number of adult guests	2
context:children	Number of children guests	-
context: hotel_classes	Filter results by # of hotel stars. You may specify one or more values between 2 and 5. Example: [3,4]	-
context: hotel_dates	Dates for staying at the hotel, from - to. Example: 2023-07-12,2023-07-13	-

All context parameters should be used in the context array as objects with key and value pairs:

...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...

Structured data

Web Scraper API can extract results HTML or JSON response that contains structured data on various elements of the results page.

Structured google_travel_hotels output (JSON)

{
    "results": [
        {
            "content": {
                "url": "https://www.google.com/travel/search?q=hotels+in+Spain&qs=OAA&hl=en&gl=us",
                "page": 1,
                "parse_status_code": 12000,
                "last_visible_page": -1,
                "results": {
                    "offers": [
                        {
                            "pos": 1,
                            "type": "hotel",
                            "name": "El Oceano Beach Hotel & Restaurant",
                            "description": "Refined property opposite the beach, plus a restaurant, an outdoor pool & 2 bars.",
                            "property_token": "ChcImqqwzb7WqI51GgsvZy8xdGZ2MXhxNBAB",
                            "hotel_class": {
                                "stars": 4,
                                "label": "4-star hotel"
                            },
                            "rating": {
                                "overall": 4.6,
                                "reviews": 1303
                            },
                            "deal": {
                                "label": "GREAT DEAL",
                                "description": "31% less than usual"
                            },
                            "eco_certified": true,
                            "pricing": {
                                "price": { "amount": 311, "currency": "USD" },
                                "price_with_tax": { "amount": 342, "currency": "USD" },
                                "total_price": { "amount": 311, "currency": "USD" },
                                "total_price_with_tax": { "amount": 342, "currency": "USD" }
                            },
                            "check_in_time": "2:00 PM",
                            "check_out_time": "12:00 PM",
                            "coordinates": {
                                "latitude": 36.4909496,
                                "longitude": -4.6948331
                            },
                            "amenities": [
                                "Breakfast ($)",
                                "Free Wi-Fi",
                                "Free parking",
                                "Pools",
                                "Hot tub",
                                "Air conditioning",
                                "Fitness center",
                                "Spa"
                            ],
                            "images": [
                                {
                                    "thumbnail_url": "https://lh3.googleusercontent.com/gps-cs-s/AC9h...=s287-w287-h192-n-k-no-v1",
                                    "original_url": "https://lh3.googleusercontent.com/gps-cs-s/AC9h..."
                                },
                                {
                                    "thumbnail_url": "https://lh3.googleusercontent.com/gps-cs-s/AB7n...=s287-w287-h192-n-k-no-v1",
                                    "original_url": "https://lh3.googleusercontent.com/gps-cs-s/AB7n..."
                                }
                            ],
                            "nearby_places": [
                                {
                                    "category_id": 1,
                                    "name": "Cabopino Beach",
                                    "transport_mode_id": 0,
                                    "travel_time": "9 min"
                                },
                                {
                                    "category_id": 3,
                                    "name": "Málaga-Costa del Sol Airport",
                                    "transport_mode_id": 0,
                                    "travel_time": "29 min"
                                }
                            ],
                            "website_url": "https://www.oceanohotel.com/",
                            "details_url": "https://www.google.com/travel/hotels/entity/ChcImqqwzb7WqI51GgsvZy8xdGZ2MXhxNBAB?q=hotels+in+Spain&hl=en&gl=us",
                            "reviews_url": "https://www.google.com/travel/hotels/entity/ChcImqqwzb7WqI51GgsvZy8xdGZ2MXhxNBAB/reviews?q=hotels+in+Spain&hl=en&gl=us"
                        },
                        {
                            "pos": 2,
                            "type": "hotel",
                            "name": "Apartamentos Vista del Mar",
                            "property_token": "ChkQ5Nm9m7SusuhsGg0vZy8xMXlzNjB6bGtsEAI",
                            "rating": {
                                "overall": 4.2,
                                "reviews": 642
                            },
                            "pricing": {
                                "price": { "amount": 96, "currency": "USD" },
                                "price_with_tax": { "amount": 105, "currency": "USD" },
                                "total_price": { "amount": 96, "currency": "USD" },
                                "total_price_with_tax": { "amount": 105, "currency": "USD" }
                            },
                            "check_in_time": "3:00 PM",
                            "check_out_time": "12:00 PM",
                            "coordinates": {
                                "latitude": 36.4363785,
                                "longitude": -5.1079798
                            },
                            "amenities": [
                                "Apartment",
                                "Sleeps 10",
                                "19 bedrooms",
                                "10 bathrooms",
                                "Airport shuttle",
                                "Outdoor pool",
                                "Free Wi-Fi"
                            ],
                            "images": [
                                {
                                    "thumbnail_url": "https://lh6.googleusercontent.com/proxy/Qnw3...=s287-w287-h192-n-k-no-v1",
                                    "original_url": "https://lh6.googleusercontent.com/proxy/Qnw3..."
                                }
                            ],
                            "nearby_places": [
                                {
                                    "category_id": 3,
                                    "name": "Alicante Airport",
                                    "transport_mode_id": 0,
                                    "travel_time": "18 min"
                                }
                            ],
                            "website_url": "http://www.hotellosangelesdenia.com/",
                            "details_url": "https://www.google.com/travel/hotels/entity/ChkQ5Nm9m7SusuhsGg0vZy8xMXlzNjB6bGtsEAI?q=hotels+in+Spain&hl=en&gl=us",
                            "reviews_url": "https://www.google.com/travel/hotels/entity/ChkQ5Nm9m7SusuhsGg0vZy8xMXlzNjB6bGtsEAI/reviews?q=hotels+in+Spain&hl=en&gl=us"
                        }
                        // ... up to 18 more offers
                    ],
                    "overview": {
                        "country": "us",
                        "language": "en",
                        "total_results": 15000
                    },
                    "pagination": {
                        "current_from": 1,
                        "current_to": 20
                    }
                }
            },
            "created_at": "2026-06-17 14:23:22",
            "updated_at": "2026-06-17 14:23:26",
            "page": 1,
            "url": "https://www.google.com/travel/search?q=hotels+in+Spain&qs=OAA&hl=en&gl=us",
            "job_id": "7473017451119126529",
            "status_code": 200
        }
    ]
}

Output dictionary

The table below presents a detailed list of each top-level element we parse, along with its description and data type.

The number of offers and certain fields may vary depending on the search query and property.

Key	Description	Type
url	URL to the Google Travel hotel search page.	string
page	Current page number of the search results.	integer
last_visible_page	Maximum page number visible in the results page.	integer
parse_status_code	The status code of the parsing job. Learn more here.	integer
results	Object containing the parsed hotel search results.	object
results.offers	List of hotel offers returned for the query. Includes pos, name, description, property_token, hotel_class, rating, deal, eco_certified, pricing, check_in_time, check_out_time, coordinates, amenities, images, nearby_places, website_url, details_url, reviews_url.	array
results.overview	General details about the search results. Includes country, language, total_results.	object
results.pagination	Details about the current page of results. Includes current_from, current_to.	object
created_at	Timestamp when the scraping job was created.	timestamp
updated_at	Timestamp when the scraping job was finished.	timestamp
job_id	ID of the job associated with the scraping job.	string
status_code	Status code of the scraping job. Learn more here.	integer