Google SERP Hotels Search API for Openclaw

A powerful search skill enabling AI agents to programmatically fetch Google Hotel SERP details, including live pricing, user ratings, and room availability.

justserpapi
v1.0.1
Jun 9, 2026
0
517
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install justserpapi-google-hotels-search

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install justserpapi-google-hotels-search using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Google SERP Hotels Search API?

The Google SERP Hotels Search API is a dedicated integration designed to extract hospitality metrics directly from Google's search result layouts. Harnessing the robust capabilities of the Just Serp API, it provides a structured conduit to fetch real-time hotel pricing, guest ratings, location coordinates, and general booking availability. Developers and enterprise aggregators can leverage this skill to automate tedious comparison checks and generate deeply optimized hospitality analytics.

As part of the broader Openclaw Skills catalog, this tool empowers autonomous agents to query Google's comprehensive travel database on-demand. By passing standard query parameters like locations and booking dates, users can query the search engine dynamically, bypassing scrapers to retrieve clean, normalized, and production-ready data structures.

Google SERP Hotels Search API Use Cases

  • Automating comparative pricing reports for regional hotel markets.
  • Powering user-facing AI travel planners with actual, real-time booking availability and room prices.
  • Conducting structured research into accommodation options based on amenities, star ratings, and price bands.
  • Aggregating vacation rentals vs. standard hotel pricing data for competitive market analysis.

How Google SERP Hotels Search API Works

  1. The AI agent identifies the travel target, incorporating required parameters: check-in date, check-out date, and destination query.
  2. Optional arguments are evaluated to narrow down results (e.g., sorting by lowest price or filtering for free cancellation).
  3. The workflow issues a GET request via the hotelsSearch operation to the target endpoint: /api/v1/google/hotels/search.
  4. Just Serp API handles the raw SERP extraction, parsing hotels, rates, reviews, and amenities.
  5. The payload is returned back to the Openclaw Skills runner as structured JSON for immediate downstream processing.

Google SERP Hotels Search API Setup

Prerequisites

Make sure Node.js is installed on your machine and you have a valid Just Serp API key.

Step-by-Step Configuration

  1. Set Environment Variable: Store your API key in your terminal context to keep credentials secure.

    export JUST_SERP_API_KEY="your_just_serp_api_key_here"
    
  2. Execute the Skill: Call the skill's CLI target with the hotelsSearch operation and your travel query payload:

    node {baseDir}/bin/run.mjs --operation "hotelsSearch" --api-key "$JUST_SERP_API_KEY" --params-json '{"query":"San Francisco","check_in_date":"2026-05-20","check_out_date":"2026-05-25"}'
    

Google SERP Hotels Search API Data Schema & Taxonomy

API Parameters Schema

Parameter Source Type Required Description
query Query String Yes Destination or hotel name (e.g., 'New York')
check_in_date Query String Yes Hotel check-in date in 'YYYY-MM-DD' format
check_out_date Query String Yes Hotel check-out date in 'YYYY-MM-DD' format
adults Query Integer No Count of adult guests
currency Query String No Three-letter ISO currency code (e.g., 'EUR')
vacation_rentals Query Boolean No Set to true to isolate vacation home rentals
html Query Boolean No Retrieve raw SERP HTML along with JSON structure

Response Structure

The output returns a structured JSON collection detailing:

  • Hotel/rental title, rating scores, review counts, and exact pricing.
  • Interactive map coordinates and booking website deep links.
  • Pagination tokens (next_page_token) and property-specific configuration tokens.

Google SERP Hotels Search API Advanced Features

  • Advanced Amenities Filters: Filter results down to precise lodging amenities (such as eco-certified, free Wi-Fi, or pools).
  • Vacation Rental Segregation: Instantly toggle standard hotel search off and search for multi-room home stays with specified bedroom and bathroom limits.
  • Native Pagination handling: Harness the next_page_token parameter directly within Openclaw Skills to loop through extensive hotel indices.
  • Raw Source Auditing: Use the html parameter to audit source pages and verify pricing displays or layout accuracy.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0

Featured*