Tripadvisor

Tripadvisor Reviews API

Get a page of Tripadvisor reviews for a location - title, full text, rating, published and trip date, trip type, reviewer name, home town and contribution count, helpful votes and any management response - as JSON. Page size follows category: 15 per page for restaurants, 10 for hotels and attractions. Costs 2 credits per request.

POST/api/v1/tripadvisor/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

location_idstring

Tripadvisor location id, 1-500 characters. Accepts 469869, d469869, or a full _Review URL. Required unless url is given.

Example: 469869

geo_idstring

Geo the location sits in. Required when location_id is a bare d-id.

Example: 30196

categoryenum<string>default:restaurants

Location family: restaurants, hotels or attractions. It sets the PAGE SIZE - 15 per page for restaurants, 10 for hotels and attractions - so it must match the location's own type on any page past the first, or the offset it builds lands on the wrong reviews.

urlstring

Full tripadvisor.com _Review URL, 1-500 characters, as an alternative to the id pair.

pageinteger

Reviews page, 1-based. Page 1 is already inside the /api/v1/tripadvisor/location response, so start at 2. A page beyond the last is a 404, not an empty result.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tripadvisor.reviews(location_id="469869", geo_id="30196", page=2)
print(results)

Response

"location_id": "469869",

"geo_id": "30196",

"type": "restaurant",

"url": "https://www.tripadvisor.com/Restaurant_Review-g30196-d469869-Reviews-or15-The_Oasis_on_Lake_Travis-Austin_Texas.html",

"name": "The Oasis on Lake Travis",

"rating": 3.7,

"review_count": 3769,

"offset": 15,

"count": 15,

"response_time": 3407,

"credits_used": 2,

"credits_remaining": 4820

}