travel

Google Hotels API

Hotel and vacation rental listings with nightly rates, ratings, amenities, and availability.

GET/api/public/v1/google-hotels

price: $0.005
atomic: 5000
free tier: 3 calls / agent
chain: base mainnet
asset: USDC
scheme: exact

agent brief

Give a destination and date range, get properties with rates and ratings.

engine: google_hotels · results key: properties · settlement: USDC / base / exact

use this when you need to

-Accommodation comparison for a trip agent
-Rate monitoring for a market

query parameters

name	type	required	description
network	base \| base-sepolia	no · default "base"	Payment network. base-sepolia returns mock data for testing.
q	string	yes	Destination query, e.g. Austin hotels
check_in_date	date	yes	YYYY-MM-DD
check_out_date	date	yes	YYYY-MM-DD
adults	integer	no · default "2"	Number of adult guests
currency	string	no · default "USD"	Currency code for rates

call it — curl

bash

# Free tier — first 3 calls per agent identity, no payment header
curl "https://marketplaceforaiagents.com/api/public/v1/google-hotels?q=AI+agents&check_in_date=2026-09-15&check_out_date=2026-09-15"

# Sandbox — signed testnet USDC, mock response, no real spend
curl "https://marketplaceforaiagents.com/api/public/v1/google-hotels?q=AI+agents&check_in_date=2026-09-15&check_out_date=2026-09-15&network=base-sepolia" \
  -H "X-PAYMENT: <base64 signed base-sepolia USDC authorization>"

# Production — signed x402 payment header, real data
curl "https://marketplaceforaiagents.com/api/public/v1/google-hotels?q=AI+agents&check_in_date=2026-09-15&check_out_date=2026-09-15" \
  -H "X-PAYMENT: <base64 signed USDC authorization>"

call it — typescript + x402-fetch

typescript

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPayment(
  "https://marketplaceforaiagents.com/api/public/v1/google-hotels?q=AI+agents&check_in_date=2026-09-15&check_out_date=2026-09-15"
);
const data = await res.json();
console.log(data.properties);

response — 200 ok

application/json

{
  "search_metadata": {
    "id": "search_...",
    "status": "Success",
    "created_at": "2026-06-18T12:00:00Z"
  },
  "search_parameters": {
    "engine": "google_hotels",
    "q": "example"
  },
  "properties": [
    {
      "position": 1,
      "title": "Example result",
      "link": "https://example.com/1",
      "snippet": "Structured JSON result."
    }
  ]
}

status codes

200data returned, response includes X-PAYMENT-RESPONSE receipt when paid

400missing or invalid required parameters

402free tier exhausted or invalid X-PAYMENT — body contains accepts[] payment requirements

404unknown endpoint slug

429upstream rate limit — retry with backoff

500upstream or settlement error