{"uid":"cap_LZKR_6X8iti3-etIBOhC4","slug":"x402engine-hotel-search-via-google-hotels-f3621498","name":"x402engine Hotel Search via Google Hotels","description":"Search hotels via Google Hotels (SerpApi). Returns properties with prices, ratings, and amenities.","url":"https://x402engine.app/api/travel/hotels","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q","checkInDate","checkOutDate"],"properties":{"q":{"type":"string","example":"hotels in Paris","description":"Search query — city name or hotel name"},"adults":{"type":"string","default":"2","description":"Number of adults"},"sortBy":{"type":"string","description":"3=Lowest price, 8=Highest rating, 13=Most reviewed"},"children":{"type":"string","description":"Number of children"},"currency":{"type":"string","default":"USD","description":"Currency code (e.g. USD, EUR)"},"maxPrice":{"type":"string","description":"Maximum price per night"},"minPrice":{"type":"string","description":"Minimum price per night"},"hotelClass":{"type":"string","description":"Star rating (2-5)"},"checkInDate":{"type":"string","example":"2026-04-15","description":"Check-in date (YYYY-MM-DD)"},"checkOutDate":{"type":"string","example":"2026-04-18","description":"Check-out date (YYYY-MM-DD)"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z73VxTcjNPojavDgL1b2o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for hotels by location and date range, returning properties with prices, ratings, and amenities via Google Hotels (powered by SerpApi).","exampleAgentPrompt":"Search for hotels in Paris for 2 adults checking in April 15 and checking out April 18 — sort by highest rating and only show options under $400 per night in USD.","exampleUseCases":[{"title":"Budget city break hotel search","prompt":"Find me the cheapest hotels in Lisbon for 2 adults, checking in May 10 and checking out May 14 — sort by lowest price and show results in USD."},{"title":"Luxury family vacation hotel lookup","prompt":"Search for 5-star hotels in Orlando for 2 adults and 2 children, checking in July 1 and checking out July 7, sorted by highest rating."},{"title":"Business trip hotel comparison","prompt":"What hotels are available in Chicago from June 3 to June 5 for 1 adult? I want to see options sorted by most reviewed so I can pick a reliable place."}],"resultDescription":"A list of hotel properties matching the search criteria, each including property name, nightly price, guest rating, star class, available amenities, and booking details — drawn from Google Hotels data via SerpApi.","failureModes":["Missing required parameters (q, checkInDate, checkOutDate) returns a validation error","Invalid date format (not YYYY-MM-DD) causes a parse error","No hotels found for the given query or date range returns an empty results set","Invalid currency code returns an error or defaults to USD","SerpApi upstream outage causes a 503 or timeout","Invalid hotelClass value (outside 2-5) may return unexpected results"],"whenToPreferThis":"Use this endpoint when an agent needs real-time hotel availability and pricing for a specific location and date range, particularly when Google Hotels coverage is desired. Prefer this over generic web search when structured hotel data (prices, ratings, amenities, star class) is required. At $0.02 USDC per call via x402 micropayment, it is cost-effective for per-query hotel discovery in travel planning agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:55:25.270Z","isFirstParty":false}