Documentation

⚠️ Notice of Product Sunset, March 30, 2026

The JSON Partner API and Feeds are in maintenance mode and will be deprecated this year. While our account management and business development teams have already reached out partners starting last quarter, we recommend reaching out if you have not been contact already.

What will replace this product?

Terra (https://docs.terra.tripadvisor.com/docs/overview), our modernized API data platform, offers improved performance, support, and expanded content. Tripadvisor will support that product on an ongoing basis.

When will the existing JSON Partner API and Feeds be deprecated?

We are careful to not distrupt existing contracts and integrations partners may have. An exact sunset date is not scheduled but we will aim to all customers migrated to Terra by 2026 Q3.

What's required of you?

Please reach out to Hailey Tonas (htonas@tripadvisor.com) and Hien Nguyen (hienguyen@tripadvisor.com), Terra's Business Development Executive and Technical Account Manager, respectively. They will provide integration guides, contract discussions, and close support to help partners through their migrations.

Thank you,

The Tripadvisor Terra Team

To access data through the Tripadvisor API, you can make calls in the format below. 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/map/42.33141,-71.099396?key=PARTNER_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.

For example:
User-Agent: My Company Name My Product Name

Reviews

/location-reviews

Call the API with the unique ID for a destination. The response will return recent reviews associated with this location.

Content Details

/location	Call the API with the unique ID for a hotel, restaurant, attraction or destination. The response provides data such as: name, address, overall traveler rating, number of reviews, link to read all reviews, link to write reviews, recent review snippets, along with additional data elements. Some data elements may not output if they do not apply to the particular type of location.
/location-hotels	Call the API with the unique ID for a destination. The response will provide a maximum list of top 10 hotels along with data for each hotel in the list. Alternatively, call the API with a comma-separated list of hotel location ids, get data for the hotels in your list.
/location-attractions	Call the API with the unique ID for a destination. The response will provide a maximum list of top 10 attractions along with data for each attraction in the list. Alternatively, call the API with a comma-separated list of attraction location ids, get data for the attractions in your list.
/location-restaurants	Call the API with the unique ID for a destination. The response will provide a maximum list of top 10 restaurants along with data for each restaurant in the list. Alternatively, call the API with a comma-separated list of restaurant location ids, get data for the restaurants in your list.

Award

/location-awards

Call the API with the unique ID for a destination. The response will provide a list of all rewards that destination has received.

Others

/location-activities	Call the API with the unique ID for a destination. The response will provide a list of all of the bookable activities available for that destination.
/location-geos	Call the API with the unique ID for a destination. The response will provide a list of the immediate children in the hierarchy of geographical locations. For example a call for Masschusetts, http://api.tripadvisor.com/api/partner/2.0/location/28942/geos?key=PARTNER_KEY will return a list containing Boston, Cape Cod, etc.
/location_mappings	Call the API with just your Partner API Key. The result returns the status of mapped properties that have been matched from partner_id to tripadvisor_id.
/map	Call the API by specifying a single Lat/Long point, returns a list of 10 properties found within a given distance from that point. If there are more than 10 properties within the radius requested, the 10 nearest properties will be returned. Alternatively, call the API with a property location ID, returns a list of 10 nearby POIs.
/map-attractions	Same as /map call, restricting results to a maximum of 10 attractions.
/map-hotels	Same as /map call, restricting results to a maximum of 10 hotels/accommodations.
/map-restaurants	Same as /map call, restricting results to a maximum of 10 restaurants.
/map-geos	Call the API by specifying a single Lat/Long point. Returns all the geographic locations near the specific point or location sorted by distance.
/travel_guide	Call the API with the unique ID for a destination. The response provides a list of travel guides for that destination. Each travel guide in the list includes associated metadata such as: guide type, guide audience, and publish date. Making a subsequent call to the API using a particular guide's unique identifier will return the POIs, recommendations, and tips for that guide.
/travel_guide-detail	Call the API with the unique ID for a particular travel guide. The response provides detail about the selected guide, including metadata and a list of POIs as chosen by the travel guide author.