---
title: "Scrape TripAdvisor reviews (hotels / restaurants / attractions)"
method: POST
path: "/travel/tripadvisor-reviews"
tags: ["Plugins"]
---

# Scrape TripAdvisor reviews (hotels / restaurants / attractions)

`POST /travel/tripadvisor-reviews`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/travel/tripadvisor-reviews`
- Auth: API key in header `x-scrapeunblocker-key`

Given a TripAdvisor place review `url` (Hotel_Review, Restaurant_Review, Attraction_Review or AttractionProductReview, any TripAdvisor site) or a `location_id`, returns the place summary (`name`, `type`, `rating`, `reviewsCount`, `ratingHistogram`, `subratings`, `address`, `coordinates`, `phone`, `website`) and its `reviews`: `title`, `text`, `rating`, `publishedDate`, `travelDate`, `tripType`, `language`, `helpfulVotes`, `user`, `subratings`, `photos` and `ownerResponse`. Newest first; pages through TripAdvisor's review pages up to `max_reviews`. Pick the review language with `language` and cut off old reviews with `since`. Billed one unit per review page fetched (`pagesFetched`).

## Query parameters

- `url` string, nullable: TripAdvisor place review page on any TripAdvisor site: Hotel_Review, Restaurant_Review, Attraction_Review or AttractionProductReview, e.g. https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-New_York_City_New_York.html. Pass this or `location_id`.
- `location_id` integer, nullable: TripAdvisor location id (the digits after -d in a place URL, e.g. 93589). Pass this or `url`.
- `max_reviews` integer: How many reviews to collect across pages (1-200). TripAdvisor shows 10 reviews per page (15 for restaurants); each page is one billed unit.
- `page` integer: 1-based review page to start from (10 reviews per page, 15 for restaurants). Use the `nextPage` of a previous response to continue.
- `language` string, nullable: Review language, which TripAdvisor ties to its site: en, de, fr, it, es, pt, nl, ja, ko, ru, sv, tr, da. Default: the language of the URL's site (tripadvisor.com = en), or - when that site lists no reviews for the place - the place's most-reviewed of these languages. Reviews written in other languages appear machine-translated, flagged by `isMachineTranslated` and `originalLanguage`.
- `since` string, nullable: Only reviews published on or after this date (YYYY-MM-DD). Stops paging once older reviews start, so it also saves pages.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Leave blank: pinning a country makes the call much slower.

## Response `200`

JSON with `place`, a `reviews` array, totals and `nextPage`.

- unknown

## Other responses

- `400`: Invalid parameters / not a TripAdvisor place review URL.
- `404`: TripAdvisor has no place at that URL / location id.
- `422`: Validation Error
- `502`: Blocked by TripAdvisor, no review list on the page, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)