Google Hotels API

Using Google Hotels API you can scrape Google Hotels result without worrying about proxy rotation and data parsing. Our API is fast and reliable. Each successful request will cost you 5 API credits.

You have to send a GET request to http://api.scrapingdog.com/google_hotels with the below-given parameters.

Parameters

Scrapingdog Parameters

Parameter
Description

api_key

required

This is your API key.

html

This will return the full HTML of the Google page. Default Value - false Type - Boolean

Search Query

Parameter
Description

query

required

This parameter specifies the search query. You can enter anything you would normally use in a standard Google Hotels search. Type - String

Geographic Location and Localization

Parameter
Description

country

This parameter specifies the country for the Google search using a two-letter country code (e.g., US for the United States, UK for the United Kingdom, or FR for France). For a complete list of supported countries, visit the Google countries page. Default Value - us Type - String

language

Language of the results. Possible Values - en, es, fr, de, etc. Visit Google's languages page for a complete list of supported countries. Default Value - en Type - String

currency

This parameter sets the currency for the returned prices. The default is USD. Refer to the Google Travel Currencies page for the complete list of supported currency codes. Type - String

Advanced Google Parameters

Parameter
Description

check_in_date required

This parameter specifies the check-in date in the format YYYY-MM-DD (e.g., 2025-08-15). Type - String

check_out_date required

This parameter specifies the check-out date, using the format YYYY-MM-DD (e.g., 2025-08-16). Type - String

adults

This parameter specifies the number of adults, with a default value of 2. Type - String

children

This parameter specifies the number of adults, with a default value of 0. Type - String

children_ages

This parameter specifies the ages of children. The valid range is 1 to 17, where children under 1 year old are considered as 1.

Examples:

  • For a single child: 5

  • For multiple children (comma-separated): 5,8,10

⚠️ The number of ages provided must match the total number of children. Type - String

Advanced Filters

Parameter
Description

sort_by

Parameter specifies how the results should be sorted. By default, results are sorted by Relevance.

Available options:

  • 3 – Sort by lowest price

  • 8 – Sort by highest rating

  • 13 – Sort by most reviews

Type - String

min_price

Parameter sets the minimum price in the range. Type - String

max_price

Specifies the maximum price in the range. Type - String

property_types

Specifies the property type(s) to include in the results. For a complete list of supported hotel property types, refer to the Google Hotels Property Types page. For vacation rentals, see the Google Vacation Rentals Property Types page.

Examples:

  • Single property type: 17

  • Multiple property types (separated by commas): 17,12,18

Type - String

amenities

This parameter allows you to filter results so that only listings with the selected amenities are included.

For the full list of available amenities, see:

Examples:

  • Single amenity: 35

  • Multiple amenities (comma-separated): 35,9,19

Type - String

rating

Parameter is used for filtering the results to certain rating. Available options: 7 - 3.5+ 8 - 4.0+ 9 - 4.5+ Type - String

Hotel Filters

Parameter
Description

brands

This parameter specifies the brands you want to focus your search on. Brand IDs can be found in the brands array within our JSON response (e.g., brands[0].id).

Examples:

  • Single brand: 33

  • Multiple brands (comma-separated): 33,67,101

Note: This parameter is not supported for Vacation Rentals.

hotel_class

This parameter filters results to include only hotels of specific star ratings.

Available options:

  • 2 → 2-star

  • 3 → 3-star

  • 4 → 4-star

  • 5 → 5-star

Example (single hotel class): 2

Example (multiple hotel classes, separated by commas): 2,3,4

Note: This parameter is not supported for Vacation Rentals.

free_cancellation

This parameter filters results to include only listings that offer free cancellation.

Note: This option is not available for Vacation Rentals.

special_offers

This parameter limits results to listings that include special offers.

Note: This option is not available for Vacation Rentals.

eco_certified

This parameter filters results to include only listings that are eco-certified.

Note: This option is not supported for Vacation Rentals.

Vacation Rentals Filters

Parameter
Description

vacation_rentals

This parameter specifies whether to search for Vacation Rentals. By default, the search is set to Hotels. Default Value - false

Type - String

bedrooms

This parameter sets the minimum number of bedrooms.

Default Value - false

Type - String

Note: This option is available only for Vacation Rentals.

bathrooms

This parameter specifies the minimum number of bathrooms.

Default Value - false

Type - String Note: This option is only available for Vacation Rentals.

Pagination

Parameter
Description

next_page_token

The next_page_token is used to get the next page results. Type: String

Property Details

Parameter
Description

property_token

This parameter retrieves detailed property information, including name, address, phone number, prices, nearby places, and more.

You can obtain the property_token from the Google Hotels Properties API. Type: String

API Example

cURL "https://api.scrapingdog.com/google_hotels?api_key=APIKEY&query=Hotels in New York&check_in_date=2025-08-19&check_out_date=2025-08-20"

API Response

{
    "ads": [
        {
            "title": "Howard Johnson by Wyndham Newark Airport",
            "source": "Booking.com",
            "source_icon": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
            "link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiVnaa6zpSPAxXuSf8BHdbXPM4YABACGgJtZA&co=1&ase=2&gclid=EAIaIQobChMIlZ2mus6UjwMV7kn_AR3W1zzOEA0YASACEgK-f_D_BwE&category=acrcp_v1_48&sig=AOD64_0HWTqV9nJiUDO6hQGUfVq5loZDyQ&adurl=",
            "property_token": "CgsIlsrqgKWto5OmARAB",
            "gps_coordinates": {
                "latitude": 40.71048400000001,
                "longitude": -74.15697800000001
            },
            "thumbnail": "https://www.google.com//lh5.googleusercontent.com/proxy/7YlKszkZI-z08MVhEvJwI9MKOBZRmqWQh1SMy4umGSoSr7G74R_VFyQfdpDgU7PjWQoyNCEBLQLTkSEhJgR42imtYUBRef9KGxHFTeFM2j7kylbXnGVFW-8m2O0kWEShX5jbMXKP5kMlKarM6gh82-56NZAt2Fo=w225-h150-k-no",
            "price": "$98",
            "reviews": 1812,
            "overall_rating": 3,
            "amenities": [
                "Beach access",
                "Restaurant",
                "Hot Tub"
            ],
            "hotel_class": 2,
            "free_cancellation": false
        },
         ......
     ],
       "brands": [
        {
            "id": 33,
            "name": "Accor Live Limitless",
            "children": [
                {
                    "id": 8,
                    "name": "Fairmont Hotels and Resorts"
                },
                {
                    "id": 84,
                    "name": "Sofitel"
                }
            ]
        },
       .....
       ],
       "properties": [
        {
            "type": "hotel",
            "title": "YOTEL New York Times Square",
            "description": "Snug rooms & suites in a hip, stylish hotel featuring a rooftop restaurant & a fitness center.",
            "link": "https://www.yotel.com/en/hotels/yotel-new-york?utm_source=Google&utm_medium=Yext_YONYC",
            "property_token": "ChcIiv7qloTyutUJGgsvZy8xdG5zc3Y3NRAB",
            "gps_coordinates": {
                "latitude": 40.7591608,
                "longitude": -73.9954657
            },
            "check_in_time": "3:00 PM",
            "check_out_time": "11:00 AM",
            "rate_per_night": {
                "lowest": "$151",
                "before_taxes_fees": "$177"
            },
            "total_rate": {
                "lowest": "$151",
                "before_taxes_fees": "$177"
            },
            "nearby_places": [
                {
                    "name": "Times Square",
                    "transportations": [
                        {
                            "type": "Public transport",
                            "duration": "8 min"
                        }
                    ]
                },
                {
                    "name": "42 St-Port Authority Bus Terminal",
                    "transportations": [
                        {
                            "type": "Walking",
                            "duration": "9 min"
                        }
                    ]
                },
                {
                    "name": "John F. Kennedy International Airport",
                    "transportations": [
                        {
                            "type": "Taxi",
                            "duration": "43 min"
                        },
                        {
                            "type": "Public transport",
                            "duration": "57 min"
                        }
                    ]
                },
                {
                    "name": "Bea",
                    "transportations": [
                        {
                            "type": "Walking",
                            "duration": "5 min"
                        }
                    ]
                }
            ],
            "hotel_class": "4-star hotel",
            "extracted_hotel_class": 4,
            "images": [
                {
                    "thumbnail": "https://lh5.googleusercontent.com/proxy/YDPcobfVgUBfUaXjVIo5kNT6HFZVlez8yu8VJy1eBvXRXcQ8QH4xKaKhKcqqmQHX1CJACn8DhXuMccLFe5CkhFDCldIAbxSaWYjXCjb9V1HLvVgB6iNpJNbOdhOfE6e6tBQ-Gv1iiSfbtR3Owom7_AM72VAH9I4=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/YDPcobfVgUBfUaXjVIo5kNT6HFZVlez8yu8VJy1eBvXRXcQ8QH4xKaKhKcqqmQHX1CJACn8DhXuMccLFe5CkhFDCldIAbxSaWYjXCjb9V1HLvVgB6iNpJNbOdhOfE6e6tBQ-Gv1iiSfbtR3Owom7_AM72VAH9I4=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipOkSPFFRhooA7oXNuO7KhhnOaYKZ6yat--utemK=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipOkSPFFRhooA7oXNuO7KhhnOaYKZ6yat--utemK=s10000-"
                },
                {
                    "thumbnail": "https://lh6.googleusercontent.com/proxy/2LCtifX5-emMos3ppPK5eXsC4QVZRVA1hcudeiNevleEj0akfGWsgFkOkx_sjbcHaVab86nupecyyHdvEsiFsRQ8JII8-q2_l2jIhQ5zBlpkg37QXSvBGM93IozOPdzD17-kf5K905jg8YE93JN9ENGy8byTy9Y=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/2LCtifX5-emMos3ppPK5eXsC4QVZRVA1hcudeiNevleEj0akfGWsgFkOkx_sjbcHaVab86nupecyyHdvEsiFsRQ8JII8-q2_l2jIhQ5zBlpkg37QXSvBGM93IozOPdzD17-kf5K905jg8YE93JN9ENGy8byTy9Y=s10000-"
                },
                {
                    "thumbnail": "https://lh5.googleusercontent.com/proxy/NAM4yJorz4JTcSC-L-XZymVL6OlMnBrcCGFWV3rMUZDuCfi4HPS61aM0_KJ2FWNzUKSs5FXReEknrXwzA3OjyumioD5WF7yA27slGIjVTQL4ptTkbSHd80LfSTLr7uvh1eCJD80ZZqUQT2_GGSC2v7-ulJfjVlU=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/NAM4yJorz4JTcSC-L-XZymVL6OlMnBrcCGFWV3rMUZDuCfi4HPS61aM0_KJ2FWNzUKSs5FXReEknrXwzA3OjyumioD5WF7yA27slGIjVTQL4ptTkbSHd80LfSTLr7uvh1eCJD80ZZqUQT2_GGSC2v7-ulJfjVlU=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipPAZvwlK4FpBueIiEqlyEfONjt9tmQt7VIEC62C=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipPAZvwlK4FpBueIiEqlyEfONjt9tmQt7VIEC62C=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipO4Yceq_66uWJmvsRylRCb70VQGZBLAKRvuZz3O=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipO4Yceq_66uWJmvsRylRCb70VQGZBLAKRvuZz3O=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipMHWAZXDyvCvryI9oucYLl8YKGET4Rm2aKos9mo=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipMHWAZXDyvCvryI9oucYLl8YKGET4Rm2aKos9mo=s10000-"
                },
                {
                    "thumbnail": "https://lh4.googleusercontent.com/proxy/d4rdOMM8qPZS-3ZGn2GgSo1dVdDRyE2l_qWDeuvj2GH9LILLOFrAB4Umt8g-DFGg55aMrnyY0LNj15Vls6fowDEgBpJ59qMhlqhoPo-RJXAEVqTqdf9T6DNmNjzN6LzIGWGOo8_RJAIS3IM9-aFqUgGanmR9zQQ=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/d4rdOMM8qPZS-3ZGn2GgSo1dVdDRyE2l_qWDeuvj2GH9LILLOFrAB4Umt8g-DFGg55aMrnyY0LNj15Vls6fowDEgBpJ59qMhlqhoPo-RJXAEVqTqdf9T6DNmNjzN6LzIGWGOo8_RJAIS3IM9-aFqUgGanmR9zQQ=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/proxy/fNsMZTakmnIIKicuWKoEymka9KjJNBZGt7Aw0WT5tGW0BFZ9jdvX7llS-eenLhVJIkJtsBf-2EoHs-jfQb1Cj_E5fMeCN5eT5ueiopDd4CKKqpy77YVxXxX2M_02mQlYboZ-AEVxp5kSrPpMF5a83lb6kTPqoZs=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/fNsMZTakmnIIKicuWKoEymka9KjJNBZGt7Aw0WT5tGW0BFZ9jdvX7llS-eenLhVJIkJtsBf-2EoHs-jfQb1Cj_E5fMeCN5eT5ueiopDd4CKKqpy77YVxXxX2M_02mQlYboZ-AEVxp5kSrPpMF5a83lb6kTPqoZs=s10000-"
                }
            ],
            "reviews": 3.9,
            "overall_rating": 9040,
            "ratings": [
                {
                    "stars": 5,
                    "count": 4051
                },
                {
                    "stars": 4,
                    "count": 2587
                },
                {
                    "stars": 3,
                    "count": 1067
                },
                {
                    "stars": 2,
                    "count": 513
                },
                {
                    "stars": 1,
                    "count": 922
                }
            ],
            "location_rating": 3.9,
            "reviews_breakdown": [
                {
                    "name": "Property",
                    "description": "Property",
                    "total_mentioned": 0,
                    "positive": 2765,
                    "negative": 0,
                    "neutral": -2765
                },
                {
                    "name": "Location",
                    "description": "Location",
                    "total_mentioned": 0,
                    "positive": 1,
                    "negative": 1217,
                    "neutral": -1218
                },
                {
                    "name": "Bathroom",
                    "description": "Bathroom and toiletries",
                    "total_mentioned": 0,
                    "positive": 2,
                    "negative": 191,
                    "neutral": -193
                },
                {
                    "name": "Room",
                    "description": "Room amenities",
                    "total_mentioned": 0,
                    "positive": 938,
                    "negative": 0,
                    "neutral": -938
                },
                {
                    "name": "Bar",
                    "description": "Bar or lounge",
                    "total_mentioned": 0,
                    "positive": 1,
                    "negative": 305,
                    "neutral": -306
                },
                {
                    "name": "Service",
                    "description": "Service",
                    "total_mentioned": 0,
                    "positive": 1624,
                    "negative": 0,
                    "neutral": -1624
                }
            ],
            "amenities": [],
            "eco_certified": true
            }
             ......
            ]

Last updated