GET
# TripAdvisor Hotel Reviews API

Extract comprehensive hotel reviews from TripAdvisor using the hotel's location ID.

## Overview

#### Rich Review Data

Get detailed reviews with user profiles, ratings, photos, trip information, and engagement metrics.

The TripAdvisor Hotel Reviews endpoint provides access to detailed review data including reviewer information, stay dates, ratings, review text, photos, helpful votes, and management responses.

### Endpoint URL

GET https://api.stayapi.com/v1/tripadvisor/hotel/reviews/{location\_id} 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| location\_id | string | Required | TripAdvisor location ID (path parameter) |
| page | integer | Optional | Page number, starts at 1 (default: 1) |
| per\_page | integer | Optional | Number of reviews per page (1-50, default: 10). At most 20 reviews are returned per page; larger values are treated as 20. |
| language | string | Optional | TripAdvisor language code, or `all` (default) to include reviews across source languages. A specific code selects the presentation language and can include an available translation. Accepted codes include `en`, `ja`, `es`, `fr`, `de`, `it`, `zhTW`, `zhCN`, `iw`, `in`, `ru`, `th`. |

#### Ordering, language, and dates

TripAdvisor provides its most-recent review order. A pinned review can appear among newer reviews, so do not assume every result is strictly descending by date. language=all includes reviews across source languages. A specific code (for example, language=ja) selects the presentation language and can include an available translation. created\_date and published\_date follow the dates TripAdvisor shows in its current review presentation.

## Response Structure

### Review Information

- `review_id` - Unique review identifier
- `title` - Review title
- `text` - Full review text
- `rating` - Overall rating (1-5)
- `published_date` - When review was posted
- `stay_date` - When the reviewer stayed

### Reviewer Details

- Username and display name
- Location
- Contribution count and helpful votes
- Profile photo URL

### Additional Data

- Trip type (business, couples, family, etc.)
- Review photos
- Helpful vote count
- Management response (if available)
- Room tip information
- Language of review

## Finding the Location ID

#### Need the Location ID?

Use the /location/extract-id endpoint to extract the location ID from any TripAdvisor hotel URL.

The location ID can be found in TripAdvisor URLs. For example:

`
            https://www.tripadvisor.com/Hotel_Review-g1224250-d305165-Reviews-Hotel.html
          `

The location ID is `305165` (the number after "d").

Request

```curl
curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/reviews/305165?page=1&per_page=10" \
  -H "x-api-key: YOUR_API_KEY"
```

Response

```json
{
  "success": true,
  "reviews": [
    {
      "id": 874521963,
      "rating": 5,
      "title": "Exceptional luxury hotel with outstanding service",
      "text": "From the moment we arrived, we were treated like royalty. The staff went above and beyond to ensure our stay was perfect.",
      "language": "en",
      "created_date": "2024-01-10",
      "published_date": "2024-01-10",
      "helpful_votes": 8,
      "user": {
        "id": "ABC123",
        "display_name": "Sarah M",
        "username": "SarahM_London",
        "is_verified": false,
        "contribution_count": 47,
        "hometown": "London, UK",
        "avatar_url": "https://media-cdn.tripadvisor.com/..."
      },
      "trip_info": {
        "stay_date": "2023-12-15",
        "trip_type": "COUPLES"
      },
      "additional_ratings": {
        "value": 5,
        "service": 5,
        "cleanliness": 5
      },
      "photos": [],
      "review_url": "https://www.tripadvisor.com/ShowUserReviews-...",
      "owner_response": {
        "text": "Dear Sarah, thank you for your wonderful review! We're delighted you enjoyed your stay and look forward to welcoming you back.",
        "published_date": "2024-01-12",
        "author": "Hotel Management",
        "connection_to_subject": "Manager"
      }
    }
  ],
  "total_count": 336,
  "review_count": 10,
  "location_id": 305165,
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total_count": 336,
    "total_pages": 34,
    "has_next": true,
    "has_previous": false
  }
}
```

```json
{
  "error": "Hotel not found",
  "detail": "No hotel found with location ID: 999999",
  "status_code": 404
}
```