This FAQ includes a range of questions, from general inquiries to product-specific issues and troubleshooting tips. We recommend using your browser's search function to find questions similar to yours. If you cannot find the answer you're looking for, please contact your Tripadvisor Account Manager. Be sure to include the product name, details of your inquiry, and any error information (such as API call logs, if available).
| Product | Question: | Answer: |
| All | Feed/Partner API response contains wrong partner IDs. | It should contain the mapping file uploaded. You can delete the mapping via self-serve deactivate mapping functionality. |
| All | CDS images file got content-type error when fetching by Java Spring RestTemplate library | Java Spring RestTemplate library isn't able to parse images with incorrect content types. Resolutions: 1) Adapt their usage of the RestTemplate library to intercept the HTTP response and convert the response Content-Type to the correct one: image/jpeg 2) use a different Java library 3) Use any other technology |
| All | For Bubble rating, when it is a new property and has a zero raitng, what will we show in the Feed? | They are likely to show different data attributes that they do have, like address, etc. (other than bubble rating) until ratings come through. Once the property starts to get reviews, the next feed will include updated bubble ratings. |
| All | How can I get Tripadvisor Location IDs for Hotels, Restaurants, and Attractions? | Please check out the Matching Property IDs page for more information. |
| All | How do I add, delete, deactivate, remap or correct mapping? | There are two options available. Option 1: Manual File - Bulk Import This method is provided for the initial setup. The partner will create their own location list following the Full Mapping Template and send it to the Tripadvisor Account Manager. Once the file has been uploaded, the matching result with correspondence TA IDs will be shared or you can retrieve with /location_mappings call." Option 2: The /location-mapper allows users to search for a Tripadvisor ID using latitude, longitude, and the property name. Filters for category, address, and phone number are available to refine the search for matching TA IDs. The response will include basic information about the matched TA ID. This call requires a CONTENT_API_KEY, which is different from the PARTNER_KEY. A Tripadvisor Account Manager will assist in populating this key. |
| All | How do I map a property ID to the corresponding Tripadvisor ID? | There are two options available. Option 1: Manual File - Bulk Import This method is provided for the initial setup. The partner will create their own location list following the Full Mapping Template and send it to the Tripadvisor Account Manager. Once the file has been uploaded, the matching result with correspondence TA IDs will be shared or you can retrieve with /location_mappings call." Option 2: The /location-mapper allows users to search for a Tripadvisor ID using latitude, longitude, and the property name. Filters for category, address, and phone number are available to refine the search for matching TA IDs. The response will include basic information about the matched TA ID. This call requires a CONTENT_API_KEY, which is different from the PARTNER_KEY. A Tripadvisor Account Manager will assist in populating this key. |
| All | How to get total POI for a specific geo? | API /location-geos and /map-geos provide it in total_results parameter |
| All | How to identity management photo? | Author name is always Management for management photo |
| All | I have a partner’s inventory file. How can they get matching TA IDs? | “Full Mapping” on Partnership Mapping Tool allows you to upload the file. The file should follow the templates: FullMapping. Once the process is completed, you will receive an email containing the results of the mapping process |
| All | I want all review data for particular contents. Which product suits me; Partner API or Feed? | All review data is not available. Partner API returns 5 most recent reviews while Feed contains all reviews posted in the last 2 weeks. |
| All | Is Hotel star ratings available? | Hotel Star Rating on Tripadvisor is provided by the 3rd party like Giata. Tripadvisor is not offering any products/serices to share. |
| All | Is it OK to round up bubble rating like 5.0 for 4.5? | Unfortunately it's not allowed |
| All | Is there a tool that allows us to find matching TA IDs? | The /location-mapper allows users to search for a Tripadvisor ID using latitude, longitude, and the property name. Filters for category, address, and phone number are available to refine the search for matching TA IDs. The response will include basic information about the matched TA ID. This call requires a CONTENT_API_KEY, which is different from the PARTNER_KEY. A Tripadvisor Account Manager will assist in populating this key. |
| All | Is Traveller’s Choice, Award data available? | Yes, it’s available in both Partner API and Feed. |
| All | The customer wants to add fields to their mapping. How can mappings be configured for customers? | Custom Field is not available for mapping. Follow either bulk Import file template or Self Serve mapping template. |
| All | We're getting a Bad Request. | Please share the URL for our investigation. Some legacy and custom products have been deprecated. |
| All | We're getting an error | Please refer to Error for a necesary action taken. If you need support, please send the full requst URL and response to Tripadvisor Account Manager for invetigation. |
| All | What does the "freeCancelation" field mean? | The hotel allows users to cancel free of charge x days before the arrival date. |
| All | What should I do if I am receiving a Bad Request? | Please created a case for TDS for our investigation. Some legacy and custom products have been deprecated. |
| All | Which product Hotel star ratings is available in? | Unfortunately, Star Rating is not available |
| All | Which product provides Hotel star ratings? | Unfortunately, Star Rating is not available. |
| All | Why are the categories in locations different from the live site? | Feed is not real-time data. It updates daily with a rolling 10 days of content. For real-time data, please use Partner API. |
| All | Why does the Feed/Partner API response contain TA IDs and partner IDs that were not included in the uploaded mapping file?. | It should contain the mapping file uploaded in the past. You can delete them via self-serve deactivate mapping functionality |
| All | Why we don’t get the same data on live? Bubble rating, traveller's ranking, and review count are different from the one in Tripadvisor live site. The latest review submitted just now is not available. |
Unfortunately, the completely-real-time data is not possible. Especially data that has an impact by user’s reviews/posts like Review count, Bubble Rating and Traveller's Ranking. Please expect 1~2 days delay in data. |
| All | The same Awards/Travelers Choice logo images URL is provided for tiny, small, and large. | It's expected. We're currently providing only large one. |
| JSON API | API calls to Partner API is returning in an unexpected format | Please share the API call logs for our investigation. |
| JSON API | API returns an error | Check if you are using the correct API key. If so, check if the property is in mapping list. |
| JSON API | Can I call the API with EAN ID? | It's possible as long as EAN ID vs TA ID list imported to their mapping |
| JSON API | Can the limit of five photos and reviews be extended for our customers, and would this require an upgrade to a premium tier or another option? | It would require a upgrade to a custom deal. Moving to a custom deal would involve a higher price point of approximately $1 million. |
| JSON API | can we specify language for review? | Yes, you can by lang= parameter on location-review API. If not specified, it's set to en as default. You can specify only 1 language code. Note that there is no way to get recent reviews in any languages |
| JSON API | Cookie Consent issue with TA logo and rating images URL | TA logo, ratings, awards image links in API response and Feed attempt to store variables in user's browser cookie. In order to avoid it, please replace the domain "www.tripadvisor.com" with "static.tacdn.com" E.g. http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.5-66381-4.png should be https://static.tacdn.com/img/cdsi/img2/ratings/traveler/4.5-66381-4.png |
| JSON API | Could you explain the differences and value between self-service and paid options? | The type of content that a partner can get through self-serve is much more limited than through sales assisted, there is also no access to Account Management or Mapping to client IDs via self-serve which means there is more manual work that the partner must complete. See the section above related to Self-Serve vs. Sales-Assisted. |
| JSON API | How are Reviews sorted in the API? | Reviews are always returned sorted by recency, with the most recent review first. |
| JSON API | How can I determine which product is more suitable for me: Content API or Partner API? | Refer to Self-Serve VS Sales-Assisted Content API(https://www.tripadvisor.com/business/insights/content-api/resources/self-service-vs-assisted-service-which-is-best-for-you) |
| JSON API | How can I display the best reviews on top? | There is no sort functionality or flag for best reviews |
| JSON API | How can Sales AssistedI customers use Nearby Search endpoints(Self Serve)? | Sales Assisted Content API has /map that returns a list of 10 properties found within a given distance from given lat/long |
| JSON API | How I can remove unnecessary attractions? | You can add subcategory parameter to filter out a certain type of attractions |
| JSON API | How often does the API sync take place? | Content delivered through the API will reflect what is available on the live site. We recommend that partners cache the content from API responses for 24 hours. This approach enables the partner application to display content more quickly if it has been previously requested while still presenting the most recent user reviews. |
| JSON API | I called location-hotels by Geo. The response doesn't have all hotels listed on the live site. | API only returns hotel, bb, specialty accommodation categories. It currently doesn't support any others. #This is not very clear in the documentation, as it only points out the categories you can filter by, but those are the same you'll see if you apply no filters. |
| JSON API | I got an error for a particular property | It's mostly likely you have a limitation of properties available. Please create a mapping file and send to Tripadvisor Account Manager |
| JSON API | I got no management photos even though I added &source=Management parameter | expected as the property has no management photos |
| JSON API | I have got reviews to display for Hotel Owners. Is there a way to let them to respond to the reviews? | This does not appear in the API response. Please create a deeplinking to the Management Center for owners to respond to reviews. Here is the URL structure. https://www.tripadvisor.com/reviews?locationId=<Tripadvisor location ID>&review=<review ID> e.g. https://www.tripadvisor.com/reviews?locationId=730099&review=686269611 The Tripadvisor location ID and the review ID can be obtained from the API response. |
| JSON API | I have hit rate limit | It's recommended to use a Multi-Get functionality that allows to call ~50 properties a call. [Internal Only] rate lmit increase needs Megan's approval(needs good reason). |
| JSON API | No data is returned for a particular property | It's mostly likely you have a limitation of properties available. Please create a mapping file and send to Tripadvisor Account Manager |
| JSON API | No data is returned when calling for attraction reviews for activities | Activities aka Attraction Products are not supported |
| JSON API | no hotels when calling locations-hotel for a specific geo | location-hotels API support only accommodations that are categorized hotels, B&B, and specialty. The geo has only lodges and campground, as a result, the response has no hotels |
| JSON API | no response for Attraction | Please check if it's Attraction-Product. Our API is NOT supporting AttractionProducts aka Activities |
| JSON API | The response includes data for an incorrect property. | It must be an mapping issue. We need mapping files: one for delete the incorrect mapping and the other for correct maping |
| JSON API | There are 2 Tripadvisor listing for a property. Which one I should call API by? | Use the old one. The new one will be merged when deduplicating |
| JSON API | We have a huge number of properties. The default rate limit is not enough. Is it possible to increase the rate limit? | It's recommended to use a Multi-Get functionality that allows to call ~50 properties a call. [Internal Only] rate lmit increase needs Megan's approval(needs good reason). |
| JSON API | What does the "freeCancelation" field mean? | The hotel has offers that a user is able to cancel with no charge x days before the arrival date. |
| JSON API | Which product suits me; Content API or Partner API? | Refer to Self-Serve VS Sales-Assisted Content API(https://www.tripadvisor.com/business/insights/content-api/resources/self-service-vs-assisted-service-which-is-best-for-you) |
| JSON API | Why don't we return Eng->Vietnamese translations? | Please refer to supported language(https://developer-tripadvisor.com/partner/supported-languages/). We support vi but limited support for some products. |
| JSON API | Why I didn’t get latest reviews from /hotel-reviews call? | Please check the parameters in the call. The default language is English. The latest review must be submitted in a different language. Also, 'all_shared=true` parameter make it to return only the reviews collected by the partner |
| JSON API | Why I didn’t retrieve reviews from /hotel-reviews call? | all_shared=true` parameter make it to return only the reviews collected by our review collection partners. Please remove the parameter to get reviews submitted on Tripadvisor. |
| JSON API | Why does the API return less restaurants than live sites? | The Location Search and Nearby Location requests return up to 10 locations based on the provided search query. |
| JSON API | Live site has a review in non-English but the /reviews response doesn't contain them. Why? |
The default value of the lang parameter is English. When lang is specified, it returns recent reviews only in the language. There is another option which is preferred_lang that Reviews written in the preferred language are returned first, although additional reviews may be returned in other languages if there are not enough reviews in the preferred language. Note that there is no parameter to get most recent reviews in any languages. |
| JSON API | Which API calls can we get review snippets? | Recent review snippets, 200 characters in length, are returned as a “reviews” array object in the main /location call (not the /location-reviews call) Note that Management responses are not returned with snippets. |
| JSON API | /location_mappings response doesn't contain all. | /location_mappings response has 1000 POIs at maximum. an URL to brows the next sets of locations in the list is provided in paging>next. |
| JSON API | The API shared photos in 5 sizes. Can we expect that all image sizes are available for all entries? | Yes, the API always provides photos in 5 sizes(Thumbnail size ("photo-t"),Large size ("photo-l"), Full size ("photo-f"), Standard size ("photo-s"), Original size ("photo-o")) |
| Legacy Widgets | Can we get management response in widget? | It depends on agreement. |
| Legacy Widgets | no ratings/reviews | because no reviews posted by users yet |
| Legacy Widgets | Widget got an error. | Please check if you have added the property in the mapping list that is tied to the widget key. Also check if you pass an correct property ID |
| Mega Feed | Add descriptions of data in each header colunmm in feed like examples data online. | Unfortunately, it’s not available. |
| Mega Feed | Are you able to provide data in CSV? | We can provide the data in either JSON or XML format. Please note that the XML file format is only available on Feed. |
| Mega Feed | Bug where photo feeds show less photos than expected | There are several things to take into consideration. 1) Feed is not real-time data. It updates daily with a rolling 10 days of content. 2) Some data may not legally be shared with partners due to the source of the data. |
| Mega Feed | Can Feeds be delivered in CSV format? | available only on XML and JSON formats. |
| Mega Feed | Can feeds be delivered via FTP? | Only delivered to S3 |
| Mega Feed | Can you Include management photos only in feed? | It's not possible to default but also depends on agreement. |
| Mega Feed | Categories in locations are different from live site | Feed Data has 2`3 days delay and it updates daily with a rolling 10 days of content. For real-time data, please use Partner API |
| Mega Feed | Increase photo count | The default is 5. It needs the contract adjustment. |
| Mega Feed | Is it expected that the booking Url and tripadvisor URL are the same? | Yes, it's expected |
| Mega Feed | Is it possible to add "Claimed property" flag to the listing that the owner has claimed? | Unfortunately it's not available |
| Mega Feed | Is it possible to add "temporarily closed" flag in feeds? | Unfortunately, it’s not possible. |
| Mega Feed | Is it possible to deliver via email? | Unfortunately it's not available |
| Mega Feed | Please include only management photos in photos feed. | It’s not possible to default. Please ask to pick up photos with "AuthorName" : "Management" from feed. |
| Mega Feed | Please provide subcategory list | https://developer-tripadvisor.com/partner/json-api/business-content/categories-subcategories-and-types/ |
| Mega Feed | There appears to be a bug where the photo feeds show less photos than expected. | There are several things to take into consideration. 1) Feed is not real-time data. It updates daily with a rolling 10 days of content. 2) Some data may not legally be shared with partners due to the source of the data. |
| Mega Feed | Wanna get Star Rating | Star Rating is not available on our all products |
| Mega Feed | What amenity data is returned in feeds vs partner api | It should be the same. |
| Mega Feed | What day of the week are Feeds refreshed? | The data is updated and delivered daily. The ReviewList is refreshed with only the newly changed reviews (those marked as new, removed, updated, or with management responses). All other Feeds will update daily, maintaining a rolling 10 days of content. |
| Mega Feed | What formats can feeds be received in? | Available only on XML and JSON formats |
| Mega Feed | What refers to for Lang= param in review feed | user's selected language |
| Mega Feed | What will appear for property without review in Feed? They disapper? | The property is still contained in feed with the following parameters. "ReviewCount" = "0", "AverageRating" and "PhotoCount" disappeard |
| Mega Feed | Why are the number of locations differences between Reviews, Photos and property feeds? | Multiple things to be concerned about. - ReviewList is updated with newly changed reviews only (reviews with status: new, removed, updated, or management response). All other feeds will update daily with a rolling 10 days of content. - Some data may not legally be shared with partners due to the source of the data. - Property feeds will include all locations that haven't been closed for more than 19 days. - Review List does not include properties with 0 review or no updated reviews - Photo List does not include properties with 0 photos. |
| Mega Feed | Why the caribbean is flagged as a country in feed? | Caribbean is categorized to country on Tripadvisor listing. It consists of Dominican Republic,Cuba,Jamaica,Guadeloupe,Puerto Rico,U.S. Virgin Islands,Martinique,Barbados,St. Barthelemy,Bahamas,Grande-Terre Island,St Martin / St Maarten,Aruba,Punta Cana,Sosua,Arrondissement of Le Marin,Havana,Out Islands,Saint-Martin, and Basse-Terre Island |
| Review Collection/RCP | Do we support attraction / activities detail data ? | No, the closest we have is this API that returns activities for a requested Geo: https://developer-tripadvisor.com/partner/json-api/documentation/location-activities/ [Internal Only] Eventually, when partner pushes back -> escalate to legal by Megan Lyon |
| Review Collection/RCP | Why widget is not integrated for a particular property? | It's mostly likely missing in mapping list |
| SynMeta/Pricing API | Are we sending mobile rate? | We detect the device type from user_agent that is required parameter in a request. We send the mobile rate back if the device type is mobile and the mobile rate is available. |
| SynMeta/Pricing API | If Mobile Only rate is available? | Yes, it's available. We detect the device type from user_agent. We send the mobile rate back if the device type is mobile and the mobile rate is available. |
| SynMeta/Pricing API | Not prices is returned | No available offer in the auction |
| SynMeta/Pricing API | The price in API response is different from the one in slot 1 in the auction on TA landing page | API returns only the cheapest rate in the auction. And it's often not displayed in slot 1 in the auction |