# Hotels.com Reviews API — JSON Data Feed

**Use case:** 

Pull Hotels.com guest reviews as structured JSON: overall rating, text, sub-ratings, traveler type and language. Ready for any data pipeline.

## Input

```json
{
  "hotelUrls": [
    "https://www.hotels.com/ho311298/aria-resort-casino-las-vegas-united-states-of-america/"
  ],
  "maxReviewsPerHotel": 500,
  "sortBy": "newest",
  "minRating": 1,
  "maxRating": 5,
  "reviewSources": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

## Output

```json
{
  "reviewId": {
    "label": "Review ID",
    "format": "string"
  },
  "hotelName": {
    "label": "Hotel name",
    "format": "string"
  },
  "source": {
    "label": "Source",
    "format": "string"
  },
  "submittedAt": {
    "label": "Submitted at",
    "format": "string"
  },
  "overallRating": {
    "label": "Rating /10",
    "format": "integer"
  },
  "ratingLabel": {
    "label": "Rating label",
    "format": "string"
  },
  "reviewText": {
    "label": "Review text",
    "format": "string"
  },
  "subRatings": {
    "label": "Sub-ratings",
    "format": "array"
  },
  "brandType": {
    "label": "Review source",
    "format": "string"
  },
  "verified": {
    "label": "Verified",
    "format": "boolean"
  },
  "reviewerName": {
    "label": "Reviewer name",
    "format": "string"
  },
  "reviewerLocation": {
    "label": "Reviewer location",
    "format": "string"
  },
  "checkInDate": {
    "label": "Check-in date",
    "format": "string"
  },
  "checkOutDate": {
    "label": "Check-out date",
    "format": "string"
  },
  "travelCompanions": {
    "label": "Travelling as",
    "format": "array"
  },
  "travelerCategories": {
    "label": "Traveler categories",
    "format": "array"
  },
  "language": {
    "label": "Language",
    "format": "string"
  },
  "helpfulVotes": {
    "label": "Helpful votes",
    "format": "integer"
  },
  "reviewPhotos": {
    "label": "Review photos",
    "format": "array"
  },
  "ownerResponse": {
    "label": "Owner response",
    "format": "object"
  },
  "hotelUrl": {
    "label": "Hotel URL",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Hotels.com Reviews Scraper 🏨 Ratings, Text & Sentiment](https://apify.com/factden/hotels-com-reviews-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/factden/hotels-com-reviews-scraper) to learn more, explore other use cases, and run it yourself.