Skip to main content
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.
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.
integer
Number of reviews to return. Use 0 for all.
date
Stop loading reviews older than this date.
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★)).
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.
boolean
default:"true"
Pull each reviewer’s name, profile pic, location, etc.

Example

Response fields

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

Example response

Abridged: long text and lists are shortened.