scraper
Back to API docs

Overview

  • Overview

SERP

  • POSTSERP

Core

  • POSTGeocode
  • POSTTranslate
  • POSTSearch
  • POSTVision
  • POSTPlaces Search
  • POSTPlace Details
  • POSTPlaces Nearby
  • POSTAutocomplete

Maps

  • POSTSearch
  • POSTPlace Details
  • POSTReviews

Hotels

  • POSTSearch
  • POSTDetail
  • POSTReviews
  • POSTPhotos

Flights

  • POSTSearch
  • POSTCalendar
  • POSTExplore

Finance

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTSearch
  • POSTEstimates
  • POSTEarnings

Hotel Search

2 credits

Search for hotels by location with filters for dates, amenities, price, and more.

POST/api/v1/tools/google/hotels/search

Parameters

locationstringrequired

Location to search, e.g. "Paris, France", "Tokyo".

checkInDatestringrequired

Check-in date in YYYY-MM-DD format.

checkOutDatestringrequired

Check-out date in YYYY-MM-DD format.

adultsnumber

Number of adults (1-9). Defaults to 2.

childrennumber

Number of children (0-9). Defaults to 0.

roomsnumber

Number of rooms (1-9). Defaults to 1.

typestring

"hotels", "vacation_rentals", or "both". Defaults to "both".

currencystring

3-letter currency code. Defaults to "USD".

minPricenumber

Minimum price filter.

maxPricenumber

Maximum price filter.

hotelClassnumber[]

Star ratings to include (2-5).

guestRatingstring

Minimum guest rating: "3.5", "4.0", or "4.5".

amenitiesstring[]

Filter by amenities: "free_wifi", "pool", "parking", "spa", "fitness_center", "restaurant", "room_service", "bar", "air_conditioning", "ev_charger", "pet_friendly", "kitchen", "washer_dryer", "accessible", "beach_access", "free_breakfast", "hot_tub".

propertyTypesstring[]

Filter by property type: "apartment_hotels", "spa_hotels", "resorts", "boutique_hotels", "hostels", "bed_and_breakfasts", "ryokans", "riads", "vacation_rentals", "motel".

freeCancellationboolean

Only show free cancellation. Defaults to false.

specialOffersboolean

Only show special offers. Defaults to false.

ecoCertifiedboolean

Only show eco-certified. Defaults to false.

sortBystring

"relevance", "price_low", "price_high", "rating", "distance". Defaults to "relevance".

maxResultsnumber

Max results. Defaults to 50.

includeDetailsboolean

Include full details per hotel. Defaults to false.

fieldsstring[]

Fields to include per result. Use ["*"] for all.

Response Schema

dataobject

Google Hotels search result

resultsobject[]

Array of hotel search results

countnumber

Total number of results returned

metaobject

Request metadata

toolstring

Tool name (google-hotels-search)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/hotels/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "location": "Paris, France",
    "checkInDate": "2026-07-01",
    "checkOutDate": "2026-07-05"
  }'

Response Example

{
  "data": {
    "results": [
      {
        "name": "Hotel Le Marais",
        "propertyId": "ChYIq_X...",
        "rating": 4.5,
        "reviewCount": 1243,
        "hotelClass": 4,
        "price": 195,
        "currency": "USD",
        "location": "4th Arrondissement, Paris",
        "amenities": [
          "free_wifi",
          "restaurant",
          "bar"
        ],
        "type": "hotel"
      },
      {
        "name": "Aparthotel Montmartre",
        "propertyId": "ChYIr_Z...",
        "rating": 4.2,
        "reviewCount": 876,
        "hotelClass": 3,
        "price": 142,
        "currency": "USD",
        "location": "18th Arrondissement, Paris",
        "amenities": [
          "free_wifi",
          "kitchen",
          "washer_dryer"
        ],
        "type": "vacation_rental"
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "google-hotels-search",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}