--- name: Google SERP Hotels Search API description: 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. author: Just Serp API homepage: https://justserpapi.com/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justserpapi_google_hotels_search&utm_content=project_link metadata: {"openclaw":{"homepage":"https://justserpapi.com/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justserpapi_google_hotels_search&utm_content=project_link","primaryEnv":"JUST_SERP_API_KEY","requires":{"bins":["node"],"env":["JUST_SERP_API_KEY"]},"skillKey":"justserpapi_google_hotels_search"}} --- # 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":"","check_in_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](https://justserpapi.com/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justserpapi_google_hotels_search&utm_content=project_link). - Authentication details: [Just Serp API Docs](https://docs.justserpapi.com/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justserpapi_google_hotels_search&utm_content=project_link). ## 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.

Google SERP Hotels Search API

Description

Latest Changes

Install Google SERP Hotels Search API with One Click