360 Secure SkillHub
360 安全技能中心

Google SERP Hotels Search API

封装 Just Serp API 的 Google 酒店搜索端点,必填查询、入住与退房日期,可选价格、星级、评分、设施、货币、国家与度假短租等筛选;由 Node 脚本调用该接口,先输出简要说明再返回原始 JSON。

justserpapi
justserpapi
热度 24.36
最近更新 2026-06-09 21:07:56
分类:生活依赖:第三方 API / 代码执行应用场景:旅行 / 研究 / 推荐 / 市场分析

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add justserpapi-google-hotels-search
Metadata
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.

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.