Google SERP Hotels Search API

Call GET /api/v1/google/hotels/search for Google SERP Hotels Search through Just Serp API with check_in_date, check_out_date, and query.

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

Operation	Version	Method	Path	OpenAPI summary
hotelsSearch	v1	GET	/api/v1/google/hotels/search	Search

Inputs

Parameter	In	Required by	Optional by	Type	Notes
adults	query	n/a	all	integer	The number of adults staying in the room
amenities	query	n/a	all	string	Filter by specific amenities (e.g., '35' for free Wi-Fi). Google Hotels Amenities (hotel amenities). Google Hotels Vacation Rentals Amenities (vacation rental amenities)
bathrooms	query	n/a	all	string	Minimum number of bathrooms required (applies to vacation rentals)
bedrooms	query	n/a	all	string	Minimum number of bedrooms required (applies to vacation rentals)
brands	query	n/a	all	string	Filter by specific hotel brand IDs. IDs can be comma-separated
check_in_date	query	all	n/a	string	The hotel check-in date in 'YYYY-MM-DD' format (e.g., '2026-05-20')
check_out_date	query	all	n/a	string	The hotel check-out date in 'YYYY-MM-DD' format (e.g., '2026-05-25')
children	query	n/a	all	integer	The number of children staying in the room
children_ages	query	n/a	all	string	The ages of the children, separated by commas (e.g., '5,10'). The number of ages must match the 'children' parameter
country	query	n/a	all	string	Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries
currency	query	n/a	all	string	The three-letter ISO currency code for displaying prices (e.g., 'USD', 'EUR'). See Google Hotels Currency
eco_certified	query	n/a	all	string	Filter for hotels that are eco-certified. Set to '1' or 'true' to enable
free_cancellation	query	n/a	all	string	Filter for hotels that offer free cancellation. Set to '1' or 'true' to enable
hotel_class	query	n/a	all	string	Filter by hotel star ratings. Supported values: '2', '3', '4', '5'. Can be comma-separated
html	query	n/a	all	boolean	Set to true to return the raw HTML of the Google search results page alongside the structured data
language	query	n/a	all	string	Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language
max_price	query	n/a	all	string	Maximum price filter for the hotel stay
min_price	query	n/a	all	string	Minimum price filter for the hotel stay
next_page_token	query	n/a	all	string	The token used to retrieve the next page of hotel results. This token is found in the 'next_page_token' field of a previous response
property_token	query	n/a	all	string	The unique token for a specific hotel property to fetch detailed information
property_types	query	n/a	all	string	Filter 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 Types
query	query	all	n/a	string	The destination or specific hotel name you are searching for (e.g., 'Paris', 'Hilton New York')
rating	query	n/a	all	string	Filter by minimum guest rating. Supported values: '7' (3.5+), '8' (4.0+), '9' (4.5+)
sort_by	query	n/a	all	string	The criteria to sort hotel results. Supported values: '3' (Lowest price), '8' (Highest rating), '13' (Most reviews)
special_offers	query	n/a	all	string	Filter for hotels currently offering special deals or discounts. Set to '1' or 'true' to enable
vacation_rentals	query	n/a	all	boolean	Set 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.