GET
# TripAdvisor Reviews from URL API

Extract hotel reviews directly from any TripAdvisor hotel URL - no location ID needed.

## Overview

#### Simplest Method

Just paste any TripAdvisor hotel URL and get reviews instantly. The API handles location ID extraction automatically.

This endpoint is a convenient wrapper that extracts the location ID from a TripAdvisor URL and retrieves reviews in one step. Perfect when you have the hotel URL but not the location ID.

### Endpoint URL

GET https://api.stayapi.com/v1/tripadvisor/hotel/reviews-from-url 

## Query Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| url | string | Required | Any valid TripAdvisor hotel URL |
| 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.

## Supported URL Formats

This endpoint accepts any valid TripAdvisor hotel URL, including:

- ✓

Standard hotel pages

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

With page numbers

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

Different language versions

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

Mobile URLs

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

## Benefits

### Why Use This Endpoint?

- No need to extract location IDs manually
- Works with any TripAdvisor hotel URL format
- Same rich review data as the location ID endpoint
- Perfect for automated data collection workflows
- Handles URL validation automatically

#### Pro Tip

The response includes the extracted location\_id, so you can use it for subsequent API calls if needed.

Request

```curl
curl -X GET "https://api.stayapi.com/v1/tripadvisor/hotel/reviews-from-url?url=https://www.tripadvisor.com/Hotel_Review-g1224250-d305165-Reviews-Hotel.html&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": "Invalid URL",
  "detail": "The provided URL is not a valid TripAdvisor hotel URL",
  "status_code": 400
}
```