{"uid":"cap_DuhgEyaUjrN1S5Zd-Nb1x","slug":"zeroclick-x402-service-registry-hotel-search-cd30bd54","name":"Hotel Search via Google Hotels","description":"Search for hotels and accommodations worldwide via Google Hotels. Input: location, check-in/check-out dates, optional guest count and sort order. Output: hotels with prices, ratings, amenities, links, and coordinates. Useful for travel planning, price comparison, and accommodation research.","url":"https://hotels.withzero.ai/run?utm_source=zero.xyz","method":"POST","headers":{"X-ZAM-Access-Key":"zeroclick"},"bodySchema":{"type":"object","required":["location","checkIn","checkOut"],"properties":{"adults":{"type":"integer","default":2,"maximum":10,"minimum":1,"description":"Number of adults (default: 2)"},"sortBy":{"enum":["relevance","lowest_price","highest_rating","most_reviewed"],"type":"string","description":"Sort order for results"},"checkIn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Check-in date in YYYY-MM-DD format"},"checkOut":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Check-out date in YYYY-MM-DD format"},"location":{"type":"string","maxLength":200,"minLength":1,"description":"Hotel location query (e.g. \"Austin, TX\" or \"hotels near Times Square\")"},"maxResults":{"type":"integer","default":10,"maximum":20,"minimum":1,"description":"Maximum results to return (default: 10, max: 20)"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["location","checkIn","checkOut","resultCount","results"],"properties":{"checkIn":{"type":"string","description":"Check-in date"},"results":{"type":"array","items":{"type":"object","required":["name","type","rating","reviews","pricePerNight","priceTotal","hotelClass","amenities","link","thumbnail","coordinates"],"properties":{"link":{"type":"string","nullable":true,"description":"Hotel listing URL"},"name":{"type":"string","description":"Hotel name"},"type":{"type":"string","description":"Property type (e.g. \"Hotel\", \"Vacation rental\")"},"rating":{"type":"number","nullable":true,"description":"Overall rating out of 5 (null if unrated)"},"reviews":{"type":"number","nullable":true,"description":"Number of reviews (null if unavailable)"},"amenities":{"type":"array","items":{"type":"string"},"description":"List of amenities"},"thumbnail":{"type":"string","nullable":true,"description":"Hotel image URL"},"hotelClass":{"type":"string","nullable":true,"description":"Hotel class (e.g. \"4-star hotel\")"},"priceTotal":{"type":"number","nullable":true,"description":"Total price in USD (null if unavailable)"},"coordinates":{"type":"object","nullable":true,"required":["latitude","longitude"],"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"description":"GPS coordinates (null if unavailable)","additionalProperties":false},"pricePerNight":{"type":"number","nullable":true,"description":"Price per night in USD (null if unavailable)"}},"additionalProperties":false},"description":"Hotel results"},"checkOut":{"type":"string","description":"Check-out date"},"location":{"type":"string","description":"The search location"},"resultCount":{"type":"number","description":"Number of results returned"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["travel","hotels","booking","accommodation","search"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":3,"rating":{"score":"0.61","successRate":"0.76","reviews":3,"stars":"3.4","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yALpr3_brRaDNwSCOZN6B","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"hotel-search:1"}],"brandName":"ZeroClick x402 Service Registry","brandSlug":"zeroclick-x402-service-registry","brandBaseUrl":"https://withzero.ai","brandDocsUrl":null,"whatItDoes":"Searches for hotels and accommodations worldwide using Google Hotels, returning prices, ratings, amenities, coordinates, and booking links for a given location and date range.","exampleAgentPrompt":"Find me hotels in Austin, TX checking in June 20 and checking out June 23 for 2 adults — sort by lowest price and show up to 15 results.","exampleUseCases":[{"title":"Business travel accommodation finder","prompt":"I need a hotel in San Francisco for next week, Monday through Wednesday, for 1 person. Can you find me options that have good ratings and are near the financial district? Show me the ones with the best reviews first."},{"title":"Group vacation rental comparison","prompt":"We're planning a beach trip to Miami from July 15 to July 22 for 6 people. Search for accommodations in that area and sort them by price so we can compare what options we have across different budgets."},{"title":"Last-minute weekend getaway planner","prompt":"Find available hotels in Denver for this coming Saturday and Sunday for 2 guests. I'd like to see what's available and their amenities — especially places with a gym and free breakfast if possible."}],"resultDescription":"An array of hotel listings each containing: hotel name, property type, star class, price per night and total stay price in USD, overall rating out of 5, review count, list of amenities, a booking/listing URL, a thumbnail image URL, and GPS latitude/longitude coordinates. Also returns the echoed location, check-in/check-out dates, and total result count.","failureModes":["No hotels found for the requested location or dates — returns empty results array","Invalid date format (not YYYY-MM-DD) causes validation error","Check-out date before check-in date returns error","Location string too vague or unrecognizable returns empty results","maxResults exceeding 20 or adults exceeding 10 causes schema validation failure","Payment failure (insufficient USDC balance) blocks the request"],"whenToPreferThis":"Use this endpoint when you need real-time hotel availability, current pricing, ratings, and amenities for a specific location and date range. Prefer this over generic web search when you need structured, machine-readable accommodation data including coordinates, price breakdowns, and direct booking links. Ideal for travel planning agents that need to compare accommodations programmatically.","instructions":null,"reviewSummary":"Hotel Search via Google Hotels delivers accurate results for location-based queries, returning prices, ratings, amenities, links, and coordinates across multiple destinations. Successful runs consistently provide useful shortlists for travel planning, though tax inclusion and bed configuration details are absent from outputs. One notable failure occurred due to incorrect default parameter types in the 'Try it' template—adults and maxResults sent as strings instead of numbers, and an invalid sortBy value—causing a charged HTTP 400 error without a result.","reviewSummaryHighlights":["Returns hotels with live prices, ratings, amenities, links, and coordinates","Handles multi-adult guest counts and specific date ranges accurately","Useful shortlists for destination-based accommodation research"],"reviewSummaryConcerns":["Default 'Try it' template sends incorrect parameter types (strings instead of numbers), causing paid validation failures","sortBy enum values not enforced in template, leading to API rejection","Tax details and bed configurations not included in output"],"reviewSummaryGeneratedAt":"2026-07-22T06:15:17.083Z","activationCount":30,"lastUsedAt":"2026-07-22T04:30:32.156Z","lastSuccessfullyRanAt":"2026-07-22T04:30:32.156Z","lastHealthCheckAt":"2026-10-10T00:38:16.925Z","isFirstParty":true,"canonicalSlug":"zeroclick-x402-service-registry-hotel-search-cd30bd54"}