← Back to Skills Marketplace
justserpapi

Google SERP Hotels Search API

by justserpapi · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
40
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install justserpapi-google-hotels-search
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.
README (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.
Usage Guidance
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.
Capability Tags
requires-sensitive-credentials
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justserpapi-google-hotels-search
  3. After installation, invoke the skill by name or use /justserpapi-google-hotels-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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
Metadata
Slug justserpapi-google-hotels-search
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.

How do I install Google SERP Hotels Search API?

Run "/install justserpapi-google-hotels-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google SERP Hotels Search API free?

Yes, Google SERP Hotels Search API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Google SERP Hotels Search API support?

Google SERP Hotels Search API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google SERP Hotels Search API?

It is built and maintained by justserpapi (@justserpapi); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463556 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259610 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200551 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191226 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190235 · by oswalpalash

💬 Comments