Google SERP Hotels Search#

Use this focused Just Serp API skill for Google SERP Hotels Search. It targets GET /api/v1/google/hotels/search. Required inputs are check_in_date, check_out_date, and query. OpenAPI describes it as: Get Google hotels Search data, including prices, ratings, and availability details, for travel comparison and hospitality market analysis.

Endpoint Scope#

• Group key: google
• Endpoint key: hotels/search
• Group family: Google SERP
• Skill slug: justserpapi-google-hotels-search

OperationVersionMethodPathOpenAPI summaryhotelsSearch``v1``GET``/api/v1/google/hotels/searchSearch

Inputs#

ParameterInRequired byOptional byTypeNotesadults``queryn/aallintegerThe number of adults staying in the roomamenities``queryn/aallstringFilter by specific amenities (e.g., '35' for free Wi-Fi). Google Hotels Amenities (hotel amenities). Google Hotels Vacation Rentals Amenities (vacation rental amenities)bathrooms``queryn/aallstringMinimum number of bathrooms required (applies to vacation rentals)bedrooms``queryn/aallstringMinimum number of bedrooms required (applies to vacation rentals)brands``queryn/aallstringFilter by specific hotel brand IDs. IDs can be comma-separatedcheck_in_date``queryalln/astringThe hotel check-in date in 'YYYY-MM-DD' format (e.g., '2026-05-20')check_out_date``queryalln/astringThe hotel check-out date in 'YYYY-MM-DD' format (e.g., '2026-05-25')children``queryn/aallintegerThe number of children staying in the roomchildren_ages``queryn/aallstringThe ages of the children, separated by commas (e.g., '5,10'). The number of ages must match the 'children' parametercountry``queryn/aallstringSet the target country code (e.g., 'us', 'uk') to localize results. See Google Countriescurrency``queryn/aallstringThe three-letter ISO currency code for displaying prices (e.g., 'USD', 'EUR'). See Google Hotels Currencyeco_certified``queryn/aallstringFilter for hotels that are eco-certified. Set to '1' or 'true' to enablefree_cancellation``queryn/aallstringFilter for hotels that offer free cancellation. Set to '1' or 'true' to enablehotel_class``queryn/aallstringFilter by hotel star ratings. Supported values: '2', '3', '4', '5'. Can be comma-separatedhtml``queryn/aallbooleanSet to true to return the raw HTML of the Google search results page alongside the structured datalanguage``queryn/aallstringSet the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Languagemax_price``queryn/aallstringMaximum price filter for the hotel staymin_price``queryn/aallstringMinimum price filter for the hotel staynext_page_token``queryn/aallstringThe token used to retrieve the next page of hotel results. This token is found in the 'next_page_token' field of a previous responseproperty_token``queryn/aallstringThe unique token for a specific hotel property to fetch detailed informationproperty_types``queryn/aallstringFilter by hotel property types. See the Google Property Types for the full list of supported hotel property types. For vacation rentals, refer to the Google Hotels Vacation Rentals Property Typesquery``queryalln/astringThe destination or specific hotel name you are searching for (e.g., 'Paris', 'Hilton New York')rating``queryn/aallstringFilter by minimum guest rating. Supported values: '7' (3.5+), '8' (4.0+), '9' (4.5+)sort_by``queryn/aallstringThe criteria to sort hotel results. Supported values: '3' (Lowest price), '8' (Highest rating), '13' (Most reviews)special_offers``queryn/aallstringFilter for hotels currently offering special deals or discounts. Set to '1' or 'true' to enablevacation_rentals``queryn/aallbooleanSet to true to search for vacation rentals instead of standard hotels

Request body: none documented; send parameters through path or query arguments.

Version Choice#

Use hotelsSearch for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint#

Supported operation IDs in this skill: hotelsSearch.

bash

node {baseDir}/bin/run.mjs --operation "hotelsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"<query>","check_in_date":"<check_in_date>","check_out_date":"<check_out_date>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, URLs, keywords, and filters unchanged.

Environment#

• Required: JUST_SERP_API_KEY
• Pass the API key with --api-key "$JUST_SERP_API_KEY"; do not paste key values into chat messages, screenshots, or logs.
• Project site: Just Serp API.
• Authentication details: Just Serp API Docs.

Output Focus#

• State the operation ID and endpoint path used, for example hotelsSearch on /api/v1/google/hotels/search.
• Echo the required lookup scope ( check_in_date, check_out_date, and query) before summarizing results.
• Prioritize fields that support this endpoint purpose: Get Google hotels Search data, including prices, ratings, and availability details, for travel comparison and hospitality market analysis.
• Return raw JSON only after the short, endpoint-specific summary.
• If the backend errors, include the backend payload and the exact operation ID.