Get Started

API Call

The JSON Partner API allows partner to have dynamic access to Tripadvisor content. The partners will create a call URL and add a unique Partner API Key that is generated by Tripadvisor. 

API calls should always reference api.tripadvisor.com even if you wish to use a different language code.

http://api.tripadvisor.com/api/partner/2.0/location/89575?key=PARTNER_API_KEY

Please, make sure you are passing the User-Agent header when making API calls. By default, most modern clients insert it automatically, but if your client is not, please add one. There may not necessarily be an end-user User-Agent if you are making calls from the server. This can be any non-empty string.
E.g. User-Agent: <My Company Name> <My Product Name>

 

Get API Key

Please contact your Tripadvisor Account Manager. 

TA ID vs Partner ID

Partners can make API calls using either their own Location ID or Tripadvisor's Location ID.

E.g. http://api.tripadvisor.com/api/partner/2.0/location/<Location_ID>?key=PARTNER_API_KEY

Tripadvisor can associate mapping information between a partner's Location ID and a Tripadvisor (TA) ID with an API Key. If the Location ID provided in an API call matches a partner's Location ID in the mapping information, the corresponding TA ID's content information will be returned. If the partner's Location ID is not found in the mapping information or if the mapping information does not exist, the Location ID in the API call will be recognized as a TA ID.

For partners who wants to call APIs with their own Location ID, they must share mapping information between their Partner ID and TA ID with TripAdvisor beforehand.

  • You don't know the TA IDs - use full mapping template to create a list and send to your Tripadivisor Account Manager
  • You know matching TA IDs - use the template and send to your Tripadvisor Account Manager

For partners who will call with TA IDs but no idea of the IDs, Tripadvisor can provide matching TA ID list to your IDs. Please use full mapping template to create a list and send to your Tripadivisor Account Manager.

Content that is commonly retrieved from the JSON Partner API:

Content

Request/Response

API

Location Reviews

 

available for hotels, restaurants, and attractions

API calls made with a Tripadvisor ID (or Partner ID) will return the following:

- Most recent 5 reviews for the property
- Jointly collected reviews (available for partners of Review Collection Platform)
- For each review: location ID, review ID, review date, username, user location
- For each review: title, full text of review, management response if one exists
- For each review: trip type, traveler rating, rating bubbles image
- For each review: link to read the review on Tripadvisor 

  /location-reviews

Business Details

available for hotels, restaurants, and attractions

API calls made with a Tripadvisor ID (or Partner ID) will return the following, if available:

- Location ID, name, address, latitude & longitude
- Read reviews link, write-a-review link
- Overall rating, ranking, subratings, awards, the number of reviews the rating is based on, rating bubbles image
- Price level symbol, accommodation category/subcategory, attraction group and category, restaurant cuisine(s)
- Three most recent review snippets of 200 characters in length, including author display name, author location, review rating, title, publish date, a link to read the full review

/location

/location-hotels

/location-attractions

/location-restaurants

Destination POI Lists

API calls made with a Tripadvisor geo location ID or latitude & longitude will return the following data, if available:

- A list of up to 10 restaurants, attractions & hotels (hereafter referred to as Points of Interest, or POIs)
- Business Details for each POI including latitude and longitude
- Results can be filtered by category/subcategory/cuisine/attraction-type
*Default radius from location ID or lat-long is 10 miles; maximum radius is 25 miles (50km).

 /map

/map-hotels

/map-attractions

/map-restaurants