> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# TripAdvisor Reviews API

> Extract Tripadvisor reviews for specified places, with text, rating, dates, reviewer, owner responses, and place details

`POST /v1/data/tripadvisor/reviews/run`

**Pricing:** $0.002 per review ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**urls** `string` *required*

TripAdvisor URL of the place to scrape reviews from.

Format e.g. `https://www.tripadvisor.com/hotels-g189158-lisbon_lisbon_district_central_portugal-hotels.html`.

**maxResults** `integer`

Number of reviews to return. Use 0 for all.

**lastReviewDate** `date`

Stop loading reviews older than this date.

**reviewRatings** `string[]` (default: \["ALL\_REVIEW\_RATINGS"])

Filter to reviews with these ratings. Leave empty for all.

Allowed values: `1` (Terrible (1★)), `2` (Poor (2★)), `3` (Average (3★)), `4` (Very Good (4★)), `5` (Excellent (5★)).

**reviewsLanguages** `string[]` (default: \["ALL\_REVIEW\_LANGUAGES"])

Filter to reviews in these languages. Leave empty for all.

183 allowed values, for example `en` (English), `ab` (Abkhaz), `aa` (Afar), `af` (Afrikaans), `ak` (Akan), `sq` (Albanian), `am` (Amharic), `ar` (Arabic), `an` (Aragonese), `hy` (Armenian). Fetch the full list with `GET /v1/data/tripadvisor/reviews?expand=options`.

**includeReviewerInfo** `boolean` (default: true)

Pull each reviewer's name, profile pic, location, etc.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/tripadvisor/reviews/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-The_Plaza-New_York_City_New_York.html",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/tripadvisor/reviews/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-The_Plaza-New_York_City_New_York.html",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/tripadvisor/reviews/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "urls": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-The_Plaza-New_York_City_New_York.html",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one review, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `reviewId` | Review ID | text |
| `reviewUrl` | Review URL | url |
| `reviewTitle` | Review Title | text |
| `reviewText` | Review Text | text |
| `rating` | Rating | rating |
| `postedDate` | Posted Date | text |
| `travelDate` | Travel Date | text |
| `tripType` | Trip Type | text |
| `language` | Language | text |
| `helpfulVotes` | Helpful Votes | number |
| `subratings` | Subratings | object\_array |
| `photos` | Photos | array |
| `ownerResponse` | Owner Response | object |
| `reviewerName` | Reviewer Name | text |
| `reviewerProfile` | Reviewer Profile | url |
| `reviewerLocation` | Reviewer Location | text |
| `reviewerContributions` | Reviewer Contributions | number |
| `reviewerAvatar` | Reviewer Avatar | url |
| `placeId` | Place ID | text |
| `place` | Place | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "tripadvisor/reviews",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "subratings": [],
      "reviewerAvatar": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/ef/32/default-avatar-2020-12.jpg",
      "reviewId": "1072329088",
      "rating": 5,
      "reviewerContributions": 14,
      "reviewTitle": "A great hotel, comfortable, extremely helpful staff, with a great lounge.",
      "photos": [],
      "reviewUrl": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113317-r1072329088-Casablanca_Hotel_By_Library_Hotel_Collection-New_York_City_New_York.html",
      "travelDate": "2026-07",
      "reviewerProfile": "https://www.tripadvisor.com/Profile/Ambover",
      "reviewerName": "Happy Jerusalemite",
      "language": "en",
      "postedDate": "2026-08-09",
      "tripType": "Family",
      "placeId": "113317",
      "reviewerLocation": "Jerusalem, Israel",
      "helpfulVotes": 0,
      "ownerResponse": {
        "text": "Dear Ambover,\n\nThank you for your wonderful review! We’re so glad you finally had the chance to stay with us and enjoyed our unique atmosphere, Rick’s Café, ...",
        "responder": "Kimberly W",
        "role": "Marketing",
        "date": "2026-08-11",
        "language": "en"
      },
      "place": {
        "name": "Casablanca Hotel By Library Hotel Collection",
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-Casablanca_Hotel_By_Library_Hotel_Collection-New_York_City_New_York.html",
        "rating": 4.8,
        "reviewsCount": 7802,
        "city": "New York City",
        "state": "NY",
        "country": "United States",
        "postalCode": "10036-6575",
        "street": "147 West 43rd Street",
        "latitude": 40.756447,
        "longitude": -73.98551,
        "locationString": "New York City, New York",
        "website": "https://casablancahotel.com/",
        "ratingBreakdown": {
          "oneStar": 34,
          "twoStar": 52,
          "threeStar": 134,
          "fourStar": 848,
          "fiveStar": 6734
        }
      },
      "reviewText": "I had wanted to stay at the Casablanca hotel ever since visiting friends who stayed there. I loved the atmosphere and the Moroccan decor at \"Rick's Bar\". Tho..."
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.