Tripadvisor

Tripadvisor Search API

List the restaurants, hotels or attractions in a Tripadvisor geo in Tripadvisor's own ranking order - rating, review count, price band, cuisines, street address, coordinates, phone, opening hours and Travelers' Choice badge - as JSON. Every row carries the location_id + geo_id pair the detail endpoints take. 30 locations per page. Costs 2 credits per request.

POST/api/v1/tripadvisor/search

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

geo_idstring

Tripadvisor geo id, 1-500 characters. Accepts 30196, g30196, or a URL carrying one. Required unless url is given - get it from /api/v1/tripadvisor/locations.

Example: 30196

categoryenum<string>default:restaurants

Listing family: restaurants, hotels or attractions. Match it to the location's own type - it selects which Tripadvisor page is fetched and, on /reviews, how many reviews a page holds.

pageinteger

Results page, 1-based. 30 locations per page. A page beyond the last is a 404, not an empty result.

urlstring

Full tripadvisor.com listing URL, 1-500 characters, as an alternative to geo_id. The host is checked by the transport and country sites are accepted.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tripadvisor.search(geo_id="30196", category="restaurants")
print(results)

Response

"geo_id": "30196",

"category": "restaurants",

"location": "Austin",

"url": "https://www.tripadvisor.com/Restaurants-g30196.html",

"page": 1,

"count": 31,

"response_time": 4464,

"credits_used": 2,

"credits_remaining": 4820

}