{"uid":"cap_aoAHF6Nntk2-duJ_IV323","slug":"amadeus-722dc0bd","name":"Amadeus Hotel Sentiment Ratings","description":"Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.","url":"https://stabletravel.dev/api/hotels/ratings","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["hotelIds"],"properties":{"hotelIds":{"type":"string","description":"Comma-separated Amadeus hotel IDs"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data"],"properties":{"data":{"type":"array","items":{}},"meta":{},"warnings":{"type":"array","items":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":[{"type":"hotel-sentiment","hotelId":"MCPAR123","overallRating":85,"numberOfReviews":1234}],"meta":{"count":1}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.108","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.108/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.108","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.108","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UzfNU8BtBWApDLDiFBUdO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.108","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves hotel sentiment ratings and guest reviews for one or more hotels by their Amadeus hotel IDs","exampleAgentPrompt":"Can you pull up the guest sentiment ratings and reviews for these Amadeus hotels: MCLONGHM, RTPARHIL, and BWNYC001 — I want to see how travelers have rated them before I recommend one?","exampleUseCases":[{"title":"Compare guest satisfaction across hotel chains","prompt":"I'm helping a client choose between three competing hotels in the same city. Can you fetch the guest sentiment ratings and reviews for these Amadeus hotel IDs so I can see which one has the best traveler satisfaction scores?"},{"title":"Validate hotel quality before corporate booking","prompt":"Our company is considering these three Amadeus hotels for our annual team retreat. Pull up the guest reviews and sentiment ratings so we can make sure we're booking somewhere with solid ratings before we commit?"},{"title":"Identify high-rated alternatives during overbooking","prompt":"The original hotel I booked just overbooked my client's dates. Can you get the sentiment scores and guest reviews for these backup Amadeus hotel IDs in the area so I can find them a quality alternative with similar ratings?"}],"resultDescription":"Returns an array of hotel sentiment data objects containing ratings scores and guest review sentiment for each requested hotel ID, with optional warnings metadata","failureModes":["Missing hotelIds parameter returns 400 error","Invalid or non-existent Amadeus hotel IDs return empty data array or 404","Malformed comma-separated ID list may cause partial results or error","Payment failure (402) if x402 USDC payment not completed","Rate limiting if too many IDs submitted at once"],"whenToPreferThis":"Use this endpoint when you need guest sentiment scores and review data for specific hotels already identified by their Amadeus hotel IDs — ideal after a hotel search has already returned IDs and you need quality/satisfaction signals to rank or compare properties","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:58:24.198Z","isFirstParty":false}