Register a free Amadeus for Developers self-service account and create an app to get an API Key/Secret.
Get an OAuth2 access token via POST /v1/security/oauth2/token (client_credentials grant) on test.api.amadeus.com.
Obtain Amadeus-specific hotelId codes for the target properties (e.g. via the Hotel List/Hotel Search API) — codes look like 'XKPARC12', not chain codes or names.
Call GET /v2/e-reputation/hotel-sentiments with a comma-separated hotelIds query param and the Bearer token.
Parse the response for overallRating, numberOfReviews, numberOfRatings, and the sentiments breakdown (sleepQuality, service, facilities, roomComforts, valueForMoney, catering, location, staff, pointsOfInterest).
Cache results locally since review-sentiment data changes infrequently.
Known gotchas
DECOMMISSIONED 2026-07-17: Amadeus shut down the Self-Service APIs portal — self-service API keys are disabled and the portal is inaccessible as of this date. These endpoints remain available only through an Amadeus Enterprise contract (Enterprise portal unaffected). Self-serve alternatives: Duffel, or an aggregator. Do not attempt self-service key registration; it was paused before shutdown.
hotelIds must be Amadeus hotel codes obtained from a separate Hotel List/Search call, not free-text hotel names.
The test environment only has sentiment data for a subset of hotels — many valid hotelIds return empty/404 in test even though they'd work in production.
overallRating and per-category scores are sentiment-analysis outputs (0-100 scale) derived from review text, not the hotel's official star rating — don't conflate the two.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?