Tripadvisor Attractions API
The things to do in a city or region, with categories and descriptions, in the site's order.
GET /v1/tripadvisor/attractions1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/tripadvisor/attractions lists the attractions and things to do in a city or region. geoId is the city's geo id: the g number in a Tripadvisor address, or the locationId of a geo match from search (187147 is Paris).
data.totalCount counts the attractions as the site does. The site's list stops at 10,000 places, and data.truncated is true when paging ends before totalCount. data.places holds this page's, in the site's own order with sponsored places left out. Each carries locationId (pass it to the attraction and attraction reviews routes), name, url, rating, reviewCount, categories (Parks, Observation Decks & Towers), description, image and award. Pass page.nextCursor back as cursor while page.hasMore is true.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Tripadvisor Attractions API FAQ
Where do I find a city's geo id?
It is the g number in any Tripadvisor address for the city (Attractions-g187147-Paris… is 187147), or the locationId of a geo match from GET /v1/tripadvisor/search?type=geo.
How do I read an attraction's reviews?
Pass a row's locationId to GET /v1/tripadvisor/attractions/{locationId}/reviews. The Eiffel Tower is 188151.
What does a geo id that does not exist return?
HTTP 200 with data.lookupStatus not_found and an empty list. Check lookupStatus before storing rows.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
Other Tripadvisor endpoints
- SearchGET /v1/tripadvisor/search
- Place by URLGET /v1/tripadvisor/place
- Hotels in a cityGET /v1/tripadvisor/hotels
- Restaurants in a cityGET /v1/tripadvisor/restaurants
- Attraction types in a cityGET /v1/tripadvisor/attractions/types
- Cruise searchGET /v1/tripadvisor/cruises
- Cruise shipGET /v1/tripadvisor/cruise-ships/{locationId}
- Cruise ship reviewsGET /v1/tripadvisor/cruise-ships/{locationId}/reviews