{"uid":"cap_IiHfkJAbzFKG3jOcF8srn","slug":"hotel-guest-reviews-by-property-token-439186a8","name":"Hotel Guest Reviews by Property Token","description":"Hotel reviews — a hotel's guest reviews by property token: rating, date, text, per-aspect subratings, highlights & the owner's reply, with category filter & paging.","url":"https://hotels.use.x402atlas.com/reviews","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":["property_token"],"properties":{"hl":{"type":"string","default":"en","maxLength":5,"description":"Language code for the reviews"},"property_token":{"type":"string","minLength":1,"description":"Property token from a /hotels/search result"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","property_token","reviews"],"properties":{"reviews":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"user":{"type":"object","properties":{"link":{"type":"string"},"name":{"type":"string"},"thumbnail":{"type":"string"}}},"rating":{"type":"integer"},"source":{"type":"string"},"snippet":{"type":"string","description":"The review text"},"response":{"type":"object","properties":{"date":{"type":"string"},"snippet":{"type":"string"}},"description":"The property's reply"},"attributes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"snippet":{"type":"string"}}}},"subratings":{"type":"object","properties":{"rooms":{"type":"integer"},"service":{"type":"integer"},"location":{"type":"integer"}}},"best_rating":{"type":"integer","description":"The rating scale's maximum"},"source_icon":{"type":"string"},"hotel_highlights":{"type":"array","items":{"type":"string"}}}}},"queried_at":{"type":"string","format":"date-time","description":"Time the lookup ran (UTC)"},"source_number":{"type":"integer","description":"Echoed when the reviews were narrowed to one third-party site"},"category_token":{"type":"string","description":"Echoed when the reviews were narrowed to one theme"},"property_token":{"type":"string"},"next_page_token":{"type":"string","description":"Pass back as next_page_token for the next page"}}}}}}},"responseSchema":{"type":"json","example":{"reviews":[{"date":"4 months ago","user":{"link":"https://www.google.com/maps/contrib/100815052880274933640?hl=en","name":"Ramandeep kaur"},"rating":4,"source":"Google","snippet":"What a beautiful place to stay! The location is perfect. The breakfast buffet was amazing — huge and full of variety. The pool area is absolutely beautiful and a perfect spot to unwind.","subratings":{"rooms":4,"service":4,"location":5},"best_rating":5,"hotel_highlights":["Romantic"]}],"queried_at":"2026-07-25T12:00:00Z","property_token":"ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE","next_page_token":"CjEIARIpCgoAP7_LACda____EhCB3gky7h3XYNgvXm4AAAAAGgn92PoCYUlVH7AYACIA:10"}},"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_IA-77n1dPsR9bG-MErL2R","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":"Fetches paginated guest reviews for a specific hotel, including ratings, review text, per-aspect subratings, highlights, and the property owner's reply.","exampleAgentPrompt":"Can you pull up the guest reviews for the Marriott Times Square — I need ratings, review snippets, any owner replies, and the per-aspect scores like rooms and service? The property token is ChIJN1t_tDeuEmsRUsoyG83frY4.","exampleUseCases":[{"title":"Pre-booking hotel quality check","prompt":"Before I book this hotel, can you fetch the latest guest reviews for property token ChIJN1t_tDeuEmsRUsoyG83frY4? I want to see the review text, overall ratings, and how guests rated the rooms and service specifically."},{"title":"Competitive reputation analysis","prompt":"I'm comparing two hotels for a conference stay — can you get the guest reviews for property token ABC123XYZ, including any owner replies and the per-aspect subratings, so I can see how management responds to complaints?"},{"title":"Travel blog content research","prompt":"I'm writing about boutique hotels in Paris and need real guest quotes and highlights for property token PARIS_HOTEL_456 — can you pull the reviews in English with their dates and any hotel-highlighted features guests mentioned?"}],"resultDescription":"Returns an array of guest review objects, each containing: review text snippet, overall integer rating and maximum scale, review date, reviewer name and profile link, source platform, per-aspect subratings (rooms, service, location), hotel highlights array, and the property's owner reply (date + text) if present. Also includes the query timestamp and total source count.","failureModes":["Missing or invalid property_token returns an error or empty reviews array","Property token from a non-hotel or expired search result may yield no data","Unsupported language code for 'hl' may fall back to English or return an error","Rate limiting or payment failure results in a 402 or 429 response","Truncated response if review count is very large and paging parameters are not used"],"whenToPreferThis":"Use this endpoint when you have a specific hotel's property_token (obtained from the /hotels/search sibling endpoint) and need detailed guest sentiment data — including per-aspect subratings, owner replies, and categorized highlights — rather than just summary star scores. Prefer this over generic review scrapers when you need structured, paginated, multi-source review data with language control.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:48.276Z","isFirstParty":false}