Google Hotels

get/google-hotels/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/google-hotels/search
  • Auth: API key in header X-API-KEY

Query parameters

engine'google_hotels' | 'null' nullable

SerpAPI-compatible engine identifier. Only google_hotels is accepted.

qstring required

Location query for hotel search (e.g., "Paris, France", "Near Eiffel Tower")

check_in_datestring date required

Check-in date in YYYY-MM-DD format (must be today or future date)

check_out_datestring date required

Check-out date in YYYY-MM-DD format (must be after check-in date)

adultsinteger nullable

Number of adult guests (1-10)

childreninteger nullable

Number of children (0-6)

currencystring nullable

3-letter currency code for prices (e.g., USD, EUR, GBP)

glstring nullable

2-letter country code for localization (e.g., us, gb, de, fr)

hlstring nullable

2-letter language code for results (e.g., en, es, fr, de)

sort_byinteger nullable

Sort order: 3 (price lowest first), 8 (rating highest first), 13 (most reviewed first)

min_priceinteger nullable

Minimum price per night filter

max_priceinteger nullable

Maximum price per night filter (must be greater than min_price)

hotel_classinteger nullable

Filter by hotel star rating IDs (comma-separated): 2, 3, 4, or 5

free_cancellationboolean nullable

Filter for hotels with free cancellation (true/false)

children_ages[]integer[]

Comma-separated children ages (1-17 years old). Count must match children.

ratinginteger nullable

Minimum guest rating filter: 7 (3.5+), 8 (4.0+), 9 (4.5+)

amenities[]integer[]

Filter by amenity IDs (SerpAPI list, comma-separated). Example: 35 (Free Wi-Fi), 9 (Free breakfast), 15 (Bar)

vacation_rentalsboolean nullable

Filter for vacation rental properties only (Airbnb-style properties) instead of hotels

eco_certifiedboolean nullable

Filter for eco-certified/sustainable hotels only

special_offersboolean nullable

Filter for hotels with special offers/deals

property_types[]integer[]

Filter by property type IDs (SerpAPI list, comma-separated). Example: 12 (Beach hotels), 1 (Apartments)

brands[]integer[]

Filter by brand IDs (use brands[].id from response)

bedroomsinteger nullable

Minimum number of bedrooms (1-20, vacation rentals only)

bathroomsinteger nullable

Minimum number of bathrooms (1-20, vacation rentals only)

next_page_tokenstring nullable

Pagination token from previous response

property_tokenstring nullable

Property token for a specific hotel (from search results)

Response

string required

Changes

No recorded changes to this operation across all 5 revisions of this API.