Plugins

Scrape TripAdvisor reviews (hotels / restaurants / attractions)

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).

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

Query parameters

urlstring 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_idinteger nullable

TripAdvisor location id (the digits after -d in a place URL, e.g. 93589). Pass this or url.

max_reviewsinteger

How many reviews to collect across pages (1-200). TripAdvisor shows 10 reviews per page (15 for restaurants); each page is one billed unit.

pageinteger

1-based review page to start from (10 reviews per page, 15 for restaurants). Use the nextPage of a previous response to continue.

languagestring 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.

sincestring nullable

Only reviews published on or after this date (YYYY-MM-DD). Stops paging once older reviews start, so it also saves pages.

proxy_countrystring 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

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

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.