{"uid":"cap_1VuN9l-BPpxoAWsbca2oB","slug":"hotel-search-rates-reviews-search-ca0c84f0","name":"Hotel Search, Rates & Reviews — Search","description":"Hotel search — find hotels & vacation rentals anywhere by destination with live nightly rates, star class, guest ratings, amenities, photos & coordinates as clean JSON.","url":"https://hotels.use.x402atlas.com/search","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":["query"],"properties":{"query":{"type":"string","maxLength":200,"description":"Destination, area or hotel name to search (e.g. \"hotels in Barcelona\", \"Bali resorts\")"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","queried_at","properties"],"properties":{"ads":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"name":{"type":"string"},"price":{"type":"string"},"source":{"type":"string"},"reviews":{"type":"integer"},"amenities":{"type":"array","items":{"type":"string"}},"thumbnail":{"type":"string"},"hotel_class":{"type":"integer"},"source_icon":{"type":"string"},"details_link":{"type":"string","description":"This API's /property URL for the ad's hotel"},"overall_rating":{"type":"number"},"property_token":{"type":"string"},"extracted_price":{"type":"number"},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"free_cancellation":{"type":"boolean"}}},"description":"Sponsored placements shown above the organic results"},"note":{"type":"string","description":"Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made."},"query":{"type":"string","description":"Echoed destination query"},"brands":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"children":{"type":"array","items":{"type":"object"}}}},"description":"Hotel brands usable as the brands filter"},"properties":{"type":"array","items":{"type":"object","required":["name"],"properties":{"deal":{"type":"string"},"link":{"type":"string","description":"Booking page for the property"},"name":{"type":"string"},"type":{"type":"string","description":"hotel or vacation rental"},"images":{"type":"array","items":{"type":"object","properties":{"thumbnail":{"type":"string"},"original_image":{"type":"string"}}}},"prices":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string","description":"Booking page for this offer"},"logo":{"type":"string"},"rooms":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"name":{"type":"string"},"rates":{"type":"array","items":{"type":"object","properties":{"link":{"type":"string"},"inclusions":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"free_cancellation":{"type":"boolean"},"breakfast_included":{"type":"boolean"}}}},"images":{"type":"array","items":{"type":"string"}},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}}}},"description":"Room types this source offers, with per-room and per-rate pricing"},"source":{"type":"string","description":"Booking site offering this rate"},"benefits":{"type":"string"},"official":{"type":"boolean","description":"True when the source is the property itself"},"num_guests":{"type":"integer"},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"discount_remarks":{"type":"array","items":{"type":"string"}},"free_cancellation":{"type":"boolean"}}},"description":"Per-source offers for the stay"},"ratings":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer"},"stars":{"type":"integer"}}}},"reviews":{"type":"integer"},"amenities":{"type":"array","items":{"type":"string"}},"total_rate":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"description":{"type":"string"},"hotel_class":{"type":"string"},"photos_link":{"type":"string","description":"This API's /photos URL for the hotel"},"details_link":{"type":"string","description":"This API's /property URL for the hotel"},"reviews_link":{"type":"string","description":"This API's /reviews URL for the hotel"},"check_in_time":{"type":"string"},"eco_certified":{"type":"boolean"},"nearby_places":{"type":"array","items":{"type":"object"}},"check_out_time":{"type":"string"},"essential_info":{"type":"array","items":{"type":"string"}},"overall_rating":{"type":"number"},"property_token":{"type":"string","description":"Pass to /property, /reviews and /photos"},"rate_per_night":{"type":"object","properties":{"lowest":{"type":"string"},"extracted_lowest":{"type":"number"},"before_taxes_fees":{"type":"string"},"extracted_before_taxes_fees":{"type":"number"}}},"gps_coordinates":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"location_rating":{"type":"number"},"deal_description":{"type":"string"},"health_and_safety":{"type":"object","description":"Health & safety practices, grouped"},"reviews_breakdown":{"type":"array","items":{"type":"object"},"description":"Themed sentiment breakdown; each entry links back to its filtered reviews"},"excluded_amenities":{"type":"array","items":{"type":"string"}},"extracted_hotel_class":{"type":"integer"}}}},"queried_at":{"type":"string","format":"date-time","description":"Time the search ran (UTC)"},"check_in_date":{"type":"string","format":"date","description":"Stay window actually priced"},"total_results":{"type":"integer","description":"Total properties matching the query upstream"},"check_out_date":{"type":"string","format":"date"},"next_page_token":{"type":"string","description":"Pass back as next_page_token for the next page"}}}}}}},"responseSchema":{"type":"json","example":{"query":"Bali Resorts","properties":[{"link":"https://www.theanvayabali.com/","name":"The Anvaya Beach Resort Bali","type":"hotel","reviews":14899,"amenities":["Free breakfast","Free Wi-Fi","Free parking","Outdoor pool","Spa"],"total_rate":{"lowest":"$289","extracted_lowest":289},"hotel_class":"5-star hotel","photos_link":"https://hotels.use.x402atlas.com/photos?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","details_link":"https://hotels.use.x402atlas.com/property?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","reviews_link":"https://hotels.use.x402atlas.com/reviews?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","check_in_time":"3:00 PM","check_out_time":"11:00 AM","overall_rating":4.7,"property_token":"ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","rate_per_night":{"lowest":"$145","extracted_lowest":145},"gps_coordinates":{"latitude":-8.7322397,"longitude":115.1659119},"location_rating":4.7,"extracted_hotel_class":5}],"queried_at":"2026-07-25T12:00:00Z","total_results":15000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IaiMuBsR8O3QND9Xw020x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for hotels and vacation rentals by destination, returning live nightly rates, star ratings, guest scores, amenities, photos, and GPS coordinates as JSON.","exampleAgentPrompt":"Can you find me hotels in Barcelona and show me the nightly rates, star ratings, and guest scores for each?","exampleUseCases":[{"title":"Vacation destination hotel scout","prompt":"I'm planning a trip to Bali — can you search for resorts there and show me the nightly prices, star ratings, guest scores, and what amenities each one has?"},{"title":"City trip accommodation comparison","prompt":"Find me hotels in Tokyo for my upcoming trip and give me a list with live rates, ratings, and coordinates so I can see what's available and where they're located."},{"title":"Remote work friendly hotel search","prompt":"Can you search for hotels in Lisbon that have good guest ratings? I want to see the nightly rates, amenities, and star class so I can pick the best spot to stay while working remotely."}],"resultDescription":"Returns a JSON object containing an array of hotel property listings for the destination, each with: hotel name, nightly price, star class, overall guest rating, amenities list, thumbnail photo URL, GPS coordinates (latitude/longitude), property token (for use with sibling detail/review/photo endpoints), and booking links. Also includes a list of hotel brand filters and optionally sponsored ad placements.","failureModes":["Empty or vague query returns a sample/example response with a note field indicating real parameters should be provided","No hotels found for obscure or misspelled destinations","Truncated results if destination query is too broad","Rate limit or payment failure returns HTTP 402 or error response","Upstream data unavailability may result in stale or missing nightly rates"],"whenToPreferThis":"Use this endpoint when you need to discover and compare multiple hotels or vacation rentals in a destination with live pricing, ratings, and amenities in a single call. It is the entry point in the hotel search workflow — use the returned property tokens to then fetch detailed profiles, reviews, or photos via the sibling endpoints. Prefer this over generic web search when you need structured, clean JSON hotel data with coordinates and real-time rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:34.883Z","isFirstParty":false}