# Fetch Reviews The Reviews endpoint retrieves reviews for a specific hotel. `GET` `https://api.rateparity.com/v1/reviews/{code}` **Query Parameters** Filtering is supported to refine the results based on the below criteria. | Name | Type | Description | | ------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `category` | [Category Type](/datatypes.md#reviewer-category-type) | Filters reviews based on the review category | | `score` | [Score Type](/datatypes.md#review-score-type) | Filters reviews by review score: `SUPERB` (9-10), `GOOD` (7-8), `PASSABLE` (5-6), `POOR` (3-4), and `VERYPOOR` (1-2). | | `country` | string | Filters reviews based on the reviewer's country. | | `reviewerLanguages` | List | Filters reviews based on the language of the review content. | | `season` | [Season Type](/datatypes.md#season-type) | Filters reviews according to the season or time of year. | | `verbose` | boolean | To include additional information when set to `true` (default: `false`). | **Pagination** See [Pagination](/pagination.md) for more details. Sorting options are `dateReviewed`, `mostRelevant` and `score`. ## Model Description See [Model Description](/model.md) for the base structure of responses. ### Data Object Fields The `data` object contains the primary response information returned by the API: | Name | Type | Description | | ------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `channels` | List of [ReviewScore](#reviewscore-object-fields) objects | Review scores and details from Airbnb. | | `score` | double | The overall average score calculated from all available sources. | | `reviews` | integer | Total number of reviews aggregated across all sources. | | `timeUpdated` | Instant | The timestamp of the last update. | | `userReviews` | List of [ReviewDetails](#reviewdetails-object-fields) objects | A list of individual user reviews with details such as reviewer name, score, title, description, and review date. | | `facilities` | List of [ReviewFacility](#reviewfacility-object-fields) objects | A list of facilities mentioned in reviews. If null, no facilities data is available. | | `tripTypes` | Map of `String` to [TripTypeScore](#triptypescore-object-fields) objects | Trip-type review score breakdown keyed by trip type, including the aggregated `all` bucket when available. Omitted when no trip type data is available. | ### ReviewScore Object Fields The `ReviewScore` object represents the scoring details for each review source: | Name | Type | Description | | ------------ | ------- | ---------------------------------------------------------- | | `title` | String | The channel name. | | `score` | double | The average review score from the source. | | `outOfScore` | integer | The maximum possible score for the source (e.g., 10 or 6). | | `total` | integer | The total number of reviews counted for this source. | ### ReviewDetails Object Fields | Name | Type | Description | | -------------- | ------- | --------------------------------------------------------------------- | | `name` | string | Name of the reviewer. | | `category` | string | Category of the reviewer (e.g., Solo traveller, Family, etc.). | | `dateReviewed` | Date | The date the review was submitted. | | `score` | double | The review score provided by the user. | | `title` | string | Title of the review. | | `description` | string | Detailed text of the review. | | `country` | string | Country of the reviewer. | | `language` | string | Language of the review. | | `photoUrl` | string | URL to the reviewer's photo, if available. | | `channel` | string | The source channel of the review (e.g. Booking.com, Tripadvisor.com). | | `hidden` | boolean | Indicates if the review is hidden (`true`) or visible (`false`). | ### ReviewFacility Object Fields | Name | Type | Description | | ----------- | ------ | ---------------------------------------------------------------------- | | `channel` | string | The source channel of the review (e.g., Booking.com, Tripadvisor.com). | | `facility` | string | The name of the facility mentioned in the review. | | `score` | double | The review score related to the facility. | | `timestamp` | Date | The date and time when the facility was reviewed. | ### TripTypeScore Object Fields | Name | Type | Description | | ---------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | | `reviewsPercent` | int | Percentage of reviews for the trip type. | | `score` | int | The score for the trip type. | | `categories` | List of [CategoryScore](#categoryscore-object-fields) objects | Category scores associated with this trip type. | | `byLanguage` | Map of `String` to [TripTypeScore](#triptypescore-object-fields) objects | Optional language-level breakdown returned for the aggregated `all` bucket and omitted for other trip types. | ### CategoryScore Object Fields | Name | Type | Description | | -------------- | -------- | ------------------------------------------------ | | `categoryName` | `String` | Name of the review category. | | `text` | `String` | Full descriptive text for the category. | | `shortText` | `String` | Short descriptive text for the category. | | `score` | `int` | Score assigned to the category. | | `count` | `int` | Number of reviews contributing to this category. | ### MetaData Object Fields | Name | Type | Description | | ---------------- | -------------------------------------------------- | -------------------------------------- | | `countries` | Map\ | The countries available for filtering. | | `filterTotals` | [FilterTotals](#filtertotals-object-fields) object | The filtering options totals. | | `sortingOptions` | List | Available options for sorting. | ### FilterTotals Object Fields | Name | Type | Description | | ------------ | ----------------------- | ----------------------------------------------------------------- | | `categories` | Map\ | The [Category Type](/datatypes.md#reviewer-category-type) totals. | | `scores` | Map\ | The [Score Type](/datatypes.md#review-score-type) totals. | | `seasons` | Map\ | The [Season Type](/datatypes.md#season-type) totals. | ## Request Example ```bash curl --location 'https://api.rateparity.com/v1/review/{code}?limit=10&page=1&sort=dateReviewed&asc=false&country=Italy&reviewerLanguages=en,it' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {JWT_TOKEN}' ``` ## 200 OK - Success ```json { "data": { "channels": [ { "title": "airbnb", "score": 10.0, "outOfScore": 10, "total": 16 }, { "title": "booking", "score": 9.0, "outOfScore": 10, "total": 367 }, { "title": "expedia", "score": 0.0, "outOfScore": 10, "total": 0 }, { "title": "google", "score": 9.6, "outOfScore": 10, "total": 85 }, { "title": "holidayCheck", "score": 0.0, "outOfScore": 6, "total": 0 }, { "title": "hotels", "score": 0.0, "outOfScore": 10, "total": 0 }, { "title": "tripadvisor", "score": 0.0, "outOfScore": 10, "total": 0 } ], "score": 9.53, "reviews": 468, "timeUpdated": "2025-04-01T00:44:37Z", "userReviews": [ { "id": 550942, "name": "Wifak", "category": "Couple", "dateReviewed": "2025-03-21T00:00:00.000+00:00", "score": 10.0, "title": "Exceptional", "description": "There are no comments available for this review", "country": "Italy", "language": "en", "photoUrl": "", "channel": "Booking.com", "hidden": false }, { "id": 537153, "name": "Schenatti", "category": "Group", "dateReviewed": "2025-02-24T00:00:00.000+00:00", "score": 9.0, "title": "Superb", "description": "There are no comments available for this review", "country": "Italy", "language": "en", "photoUrl": "", "channel": "Booking.com", "hidden": false }, { "id": 510078, "name": "Cinzia", "category": "Couple", "dateReviewed": "2025-01-06T00:00:00.000+00:00", "score": 9.0, "title": "Superb", "description": "Colazione esterna in un bel locale a pochi minuti a piedi, possibilità di scelta di 4 menu per tutti i gusti, buono tutto e abbondante. Il proprietario super ospitale e disponibile per ogni evenienza e consiglio. Nella camera c'è anche una cucina che noi non abbiamo usato ma super utile. Posizione strategica per raggiungere a piedi il tutto!", "language": "it", "country": "Italy", "photoUrl": "", "channel": "Booking.com", "hidden": false }, { "id": 460086, "name": "Fabysmile", "category": "Couple", "dateReviewed": "2024-09-24T00:00:00.000+00:00", "score": 10.0, "title": "Posizione buonissima", "description": "Posizione ottima, stanza pulita e disponibilità dell'host. Spiegazioni accurate per entrare in struttura e per fare il check-in.", "language": "it", "country": "Italy", "photoUrl": "", "channel": "Booking.com", "hidden": false }, { "id": 440578, "name": "Alessandro", "category": "Solo traveller", "dateReviewed": "2024-08-29T00:00:00.000+00:00", "score": 9.0, "title": "Superb", "description": "Struttura nuova accogliente che nel suo iinterno richiama li stile del quartiere in cui si trova ...vengono riprodotte le più belle opere di strettamente art presenti in zona .. stanza pulita ...cucina nuova e pulita ,..staff presente e disponibile ... posizione ottima ...", "language": "it", "country": "Italy", "photoUrl": "", "channel": "Booking.com", "hidden": false } ], "facilities": [ { "channel": "Booking.com", "facility": "staff", "score": 9.5 }, { "channel": "Booking.com", "facility": "facilities", "score": 9.0 }, { "channel": "Booking.com", "facility": "cleanliness", "score": 9.2 }, { "channel": "Booking.com", "facility": "comfort", "score": 9.1 }, { "channel": "Booking.com", "facility": "valueformoney", "score": 8.9 }, { "channel": "Booking.com", "facility": "location", "score": 9.4 }, { "channel": "Booking.com", "facility": "freewifi", "score": 9.4 } ], "tripTypes": { "couple": { "reviewsPercent": 41, "score": 84, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Excellent location", "score": 91, "count": 287 }, { "categoryName": "Service", "text": "Fantastic service.", "shortText": "Very friendly service", "score": 88, "count": 214 }, { "categoryName": "Room", "text": "Comfortable and well-appointed room.", "shortText": "Comfortable room", "score": 74, "count": 198 } ] }, "family": { "reviewsPercent": 27, "score": 81, "categories": [ { "categoryName": "Location", "text": "Great area for families with children.", "shortText": "Great for families", "score": 89, "count": 143 }, { "categoryName": "Breakfast", "text": "Wide selection for all tastes.", "shortText": "Good breakfast selection", "score": 80, "count": 96 }, { "categoryName": "Comfort", "text": "Decent comfort for a family stay.", "shortText": "Reasonably comfortable", "score": 69, "count": 88 } ] }, "business": { "reviewsPercent": 19, "score": 78, "categories": [ { "categoryName": "WiFi", "text": "Consistently reliable and fast internet.", "shortText": "Reliable internet", "score": 82, "count": 67 }, { "categoryName": "Service", "text": "Professional and prompt staff.", "shortText": "Efficient staff", "score": 79, "count": 58 }, { "categoryName": "Room", "text": "Good desk space for working.", "shortText": "Adequate workspace", "score": 72, "count": 61 } ] }, "solo": { "reviewsPercent": 13, "score": 86, "categories": [ { "categoryName": "Location", "text": "Perfectly situated for exploring the city solo.", "shortText": "Easy to get around", "score": 94, "count": 52 }, { "categoryName": "Cleanliness", "text": "Spotless rooms and common areas.", "shortText": "Very clean", "score": 87, "count": 49 }, { "categoryName": "Amenities", "text": "Everything you need for a comfortable stay.", "shortText": "Useful amenities", "score": 73, "count": 31 } ] }, "all": { "reviewsPercent": 100, "score": 84, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 97, "count": 4770 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 91, "count": 2958 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 85, "count": 2050 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 82, "count": 1408 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 63, "count": 4185 }, { "categoryName": "WiFi", "text": "Internet is average.", "shortText": "Regular internet service", "score": 60, "count": 95 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 45, "count": 2658 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 39, "count": 982 }, { "categoryName": "Value", "text": "Average value.", "shortText": "Fairly good value for money", "score": 66, "count": 54 }, { "categoryName": "Food", "text": "Tasty food.", "shortText": "Delicious food", "score": 73, "count": 30 } ], "byLanguage": { "de": { "reviewsPercent": 39, "score": 83, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 96, "count": 1265 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 92, "count": 813 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 86, "count": 616 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 81, "count": 341 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 63, "count": 1147 }, { "categoryName": "WiFi", "text": "Internet is average.", "shortText": "Regular internet service", "score": 57, "count": 24 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 46, "count": 735 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 39, "count": 252 } ] }, "en": { "reviewsPercent": 30, "score": 85, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 99, "count": 1152 }, { "categoryName": "Service", "text": "Great service.", "shortText": "Fantastic service", "score": 89, "count": 763 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 85, "count": 413 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 83, "count": 337 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 66, "count": 975 }, { "categoryName": "WiFi", "text": "Internet is average.", "shortText": "Regular internet service", "score": 65, "count": 40 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 45, "count": 572 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 38, "count": 277 } ] }, "es": { "reviewsPercent": 6, "score": 86, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 237 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 91, "count": 140 }, { "categoryName": "Breakfast", "text": "Good breakfast.", "shortText": "Tasty breakfast", "score": 79, "count": 75 }, { "categoryName": "Cleanliness", "text": "Good cleanliness.", "shortText": "Clean", "score": 72, "count": 66 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 55, "count": 183 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 49, "count": 45 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 34, "count": 123 } ] }, "fi": { "reviewsPercent": 1, "score": 85, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 16 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 90, "count": 11 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 85, "count": 8 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 85, "count": 12 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 60, "count": 12 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 48, "count": 11 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 37, "count": 5 } ] }, "fr": { "reviewsPercent": 4, "score": 87, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 118 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 90, "count": 63 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 84, "count": 25 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 84, "count": 61 }, { "categoryName": "Value", "text": "Average value.", "shortText": "Fairly good value for money", "score": 66, "count": 27 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 66, "count": 102 }, { "categoryName": "Comfort", "text": "Average comfort.", "shortText": "Comfortable", "score": 50, "count": 76 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 41, "count": 32 } ] }, "he": { "reviewsPercent": 2, "score": 87, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 97, "count": 49 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 93, "count": 28 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 85, "count": 14 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 82, "count": 24 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 57, "count": 47 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 43, "count": 35 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 35, "count": 5 } ] }, "it": { "reviewsPercent": 6, "score": 84, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 99, "count": 221 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 91, "count": 110 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 83, "count": 71 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 82, "count": 96 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 69, "count": 175 }, { "categoryName": "Comfort", "text": "Average comfort.", "shortText": "Comfortable", "score": 52, "count": 117 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 42, "count": 31 } ] }, "nl": { "reviewsPercent": 4, "score": 83, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 97, "count": 162 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 86, "count": 90 }, { "categoryName": "Service", "text": "Great service.", "shortText": "Fantastic service", "score": 86, "count": 70 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 85, "count": 55 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 64, "count": 163 }, { "categoryName": "WiFi", "text": "Internet is average.", "shortText": "Regular internet service", "score": 52, "count": 7 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 44, "count": 109 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 36, "count": 41 } ] }, "no": { "reviewsPercent": 1, "score": 88, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 18 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 92, "count": 9 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 87, "count": 7 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 56, "count": 15 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 40, "count": 8 } ] }, "pl": { "reviewsPercent": 1, "score": 91, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 94, "count": 35 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 93, "count": 15 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 87, "count": 10 }, { "categoryName": "Food", "text": "Tasty food.", "shortText": "Delicious food", "score": 73, "count": 15 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 58, "count": 19 }, { "categoryName": "Comfort", "text": "Average comfort.", "shortText": "Comfortable", "score": 50, "count": 7 } ] }, "pt": { "reviewsPercent": 2, "score": 87, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 65 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 92, "count": 35 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 84, "count": 30 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 80, "count": 11 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 62, "count": 52 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 46, "count": 25 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 44, "count": 13 } ] }, "ru": { "reviewsPercent": 1, "score": 88, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 32 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 91, "count": 24 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 82, "count": 7 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 82, "count": 17 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 66, "count": 41 }, { "categoryName": "Comfort", "text": "Average comfort.", "shortText": "Comfortable", "score": 50, "count": 30 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 40, "count": 7 } ] }, "sv": { "reviewsPercent": 1, "score": 81, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 99, "count": 45 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 84, "count": 31 }, { "categoryName": "Service", "text": "Great service.", "shortText": "Fantastic service", "score": 84, "count": 17 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 80, "count": 14 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 64, "count": 38 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 45, "count": 29 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 35, "count": 13 } ] }, "tr": { "reviewsPercent": 2, "score": 85, "categories": [ { "categoryName": "Location", "text": "Terrific location.", "shortText": "Great location", "score": 98, "count": 90 }, { "categoryName": "Service", "text": "World class service.", "shortText": "Fantastic service", "score": 93, "count": 47 }, { "categoryName": "Breakfast", "text": "Breakfast is good.", "shortText": "Tasty breakfast", "score": 84, "count": 28 }, { "categoryName": "Cleanliness", "text": "Generally very clean.", "shortText": "Clean", "score": 84, "count": 42 }, { "categoryName": "Room", "text": "Rooms are ok.", "shortText": "Room is all right", "score": 54, "count": 69 }, { "categoryName": "Comfort", "text": "Not very comfortable.", "shortText": "More comfort would be nice", "score": 42, "count": 46 }, { "categoryName": "Amenities", "text": "Bad amenities.", "shortText": "Amenities are not the best", "score": 38, "count": 9 } ] } } } } } } ``` ## 400 Bad Request ## 401 Unauthorized ```json { "metadata": { "timestamp": "2025-02-27T10:54:03.474744" }, "error": { "message": "Unauthorized user" } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.rateparity.com/reviews/fetch.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.