← 返回 Skills 市场

Google SERP Hotels Search API

Name: Google SERP Hotels Search API
Author: justserpapi

作者 justserpapi · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install justserpapi-google-hotels-search

功能描述

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.

使用说明 (SKILL.md)

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). \x3Ca href="/reference/hotels/google-hotels-amenities">Google Hotels Amenities\x3C/a> (hotel amenities). \x3Ca href="/reference/hotels/google-hotels-vacation-rentals-amenities">Google Hotels Vacation Rentals Amenities\x3C/a> (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 \x3Ca href="/reference/google-countries">Google Countries\x3C/a>
`currency`	`query`	n/a	all	`string`	The three-letter ISO currency code for displaying prices (e.g., 'USD', 'EUR'). See \x3Ca href="/reference/hotels/google-hotels-currency">Google Hotels Currency\x3C/a>
`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 \x3Ca href="/reference/google-language">Google Language\x3C/a>
`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 \x3Ca href="/reference/hotels/google-hotels-property-types">Google Property Types\x3C/a> for the full list of supported hotel property types. For vacation rentals, refer to the \x3Ca href="/reference/hotels/google-hotels-vacation-rentals-property-types">Google Hotels Vacation Rentals Property Types\x3C/a>
`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":"\x3Cquery>","check_in_date":"\x3Ccheck_in_date>","check_out_date":"\x3Ccheck_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.

安全使用建议

Install only if you are comfortable sharing hotel search terms, dates, and filters with Just Serp API and using a JUST_SERP_API_KEY for that service. Avoid using it for sensitive travel plans unless that sharing is acceptable.

能力标签

requires-sensitive-credentials

能力评估

✓ Purpose & Capability

The stated purpose, documentation, generated operation metadata, and Node helper all align around one GET endpoint: /api/v1/google/hotels/search on api.justserpapi.com.

ℹ Instruction Scope

Instructions are limited to collecting required hotel search fields and running the bundled helper; the skill does not add an explicit consent prompt, but the third-party API use is visible in the name, description, endpoint documentation, and command.

✓ Install Mechanism

The artifact contains SKILL.md, generated operation docs, generated operation JSON, and a Node runner; there are no package install scripts, postinstall hooks, or hidden setup steps.

ℹ Credentials

Network access and JUST_SERP_API_KEY are required, and hotel destination/date/filter data is sent to Just Serp API; that is proportionate to the declared search function.

✓ Persistence & Privilege

No persistence, background worker, privilege escalation, local file indexing, credential-store reading, or mutation of user accounts is present in the artifacts reviewed.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install justserpapi-google-hotels-search
安装完成后，直接呼叫该 Skill 的名称或使用 /justserpapi-google-hotels-search 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Endpoint summary in skill documentation changed from "Hotels Search" to "Search" for clarity. - Cleaned up generated documentation for consistency and minor formatting. - Removed the unused skill-card.md file. - No API or interface changes; these are doc and metadata updates only.

v1.0.0

Initial publish

元数据

Slug justserpapi-google-hotels-search

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题