MakeMyTrip Hotel Reviews API
Read guest reviews and preserve their original source and pagination context.
Overview
Read MakeMyTrip hotel reviews with published text, ratings, stay context, source labels, and source-aware pagination. Use a numeric hotel ID returned by Search.
Scope
Only Most relevant sorting is supported. Within the same source, continue with next_start and next_ota while has_more is true. When source_changed is true, next_start is null: a safe cross-source offset is not supplied. Stop automatic pagination instead of inventing an offset. Keep the source with each review.
Authentication
Send your StayAPI key in the X-API-Key header. Successful requests return JSON; failures use RFC 7807 Problem Details.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| hotel_id | string | Required | Numeric MakeMyTrip hotel ID from Search, 1 to 32 digits. Keep it as a string. |
| start | integer | Optional | Source-specific offset, 0 to 100,000. Default: 0. |
| limit | integer | Optional | Requested reviews, 1 to 50. Default: 10. |
| sort | string | Optional | Default and only accepted value: Most relevant. |
| next_ota | string | Optional | Source selector: MMT (default), MMT_RATING, EXT, or MANUAL. Use the returned next_ota with next_start for same-source continuation. |
Response schema
Examples are illustrative. Prices and available content depend on the requested stay and property.
| Field | Type | Description |
|---|---|---|
| success / hotel_id | boolean / string | Success flag and requested hotel ID. |
| reviews | array | Nullable review_id, date, rating, title, text, reviewer_name, travel_type, stay_details, and source. |
| has_more / start / source | boolean / integer / string|null | Provider continuation flag, requested offset, and current review source. |
| source_changed | boolean | Whether the next source differs from the current source. |
| next_start / next_ota | integer|null / string|null | Same-source next offset and provider next-source value. next_start is null on source changes or at the end. |
| review_counts | object | Nullable counts for makemytrip, expedia, vrbo, goibibo, and indian review groups. |
Errors and limitations
Errors use RFC 7807 Problem Details with provider: "makemytrip", and a correlation id when supplied.
- 400 INVALID_INPUT: invalid stay dates, city code, occupancy, or a cursor from another search.
- 401 / 402 / 429: check your API key, available quota, and account limits.
- 422: a required parameter is missing or outside its declared type, range, or enum.
- 502 UPSTREAM_ERROR: MakeMyTrip could not complete the request.
- 503: service temporarily unavailable. Honor
Retry-Afterwhen supplied. - 504 UPSTREAM_TIMEOUT: the provider request timed out.