Tripadvisor Reviews API Documentation
The Tripadvisor Reviews API allows you to retrieve and paginate through all available reviews for any Tripadvisor place. You can filter reviews by star rating, language, traveler type, and time of year, and sort by recency or detail. The API returns text, photos, ratings, author and more for each review.
API Parameters
Place ID
-
- Name
-
place_id - Required
- Required
- Description
-
Parameter defines the Tripadvisor location ID for the place whose reviews you want to retrieve. You can find this ID from a Tripadvisor Search API response in the
place_idfield.
Search Query
-
- Name
-
q - Required
- Optional
- Description
-
Full-text search within reviews. Returns reviews whose text mentions the query. Example:
madrid.
Languages
-
- Name
-
translate - Required
- Optional
- Description
-
Controls whether reviews are machine-translated.
true(default): reviews from every original language are translated tolanguage.false: reviews are returned in their original language.
original_languagefilters by source language in both modes. If omitted, reviews from all original languages are returned.
-
- Name
-
language - Required
- Optional
- Description
-
Target language for machine-translated reviews. Only has effect when
translate=true(default). Reviews from all languages are translated to this language. Check the full list of supported Tripadvisor languages. Defaults toen.
-
- Name
-
original_language - Required
- Optional
- Description
-
Filter reviews by the language(s) they were originally written in. Only has effect when
translate=false. Comma-separated values accepted (e.g.,en,en,es). Check the full list of supported Tripadvisor languages.
Filters
-
- Name
-
rating - Required
- Optional
- Description
-
Filter reviews by star rating. Comma-separated values from
1to5. Example:4,5returns only 4 and 5 star reviews.
-
- Name
-
trip_type - Required
- Optional
- Description
-
Filter reviews by travel type. Comma-separated values accepted. Supported values:
families,couples,solo,business,friends. Example:families,couples.
-
- Name
-
time_of_year - Required
- Optional
- Description
-
Filter reviews by travel period. Comma-separated values accepted. Supported values:
jan,feb,mar,apr,may,jun,jul,aug,sep,oct,nov,dec. Filtering by trimester is also supported:mar_may,jun_aug,sep_nov,dec_feb. Example:jan,jun.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Sort order for reviews. Supported values:
most_recent,detailed_reviews.
Localization
-
- Name
-
tripadvisor_domain - Required
- Optional
- Description
-
This parameter defines the Tripadvisor domain to use. Check the full list of supported Tripadvisor domains.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
tripadvisor_reviews.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
API Examples
Reviews
https://www.searchapi.io/api/v1/search?engine=tripadvisor_reviews&place_id=190164
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "tripadvisor_reviews",
"place_id": "190164"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_abc123def456ghi789",
"status": "Success",
"created_at": "2026-01-15T14:30:00Z",
"request_time_taken": 1.2,
"parsing_time_taken": 0.1,
"total_time_taken": 1.3,
"request_url": "https://www.tripadvisor.com/190164",
"html_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789"
},
"search_information": {
"total_reviews": 27242,
"sort_by": "most_recent"
},
"place": {
"id": 190164,
"title": "Mercat de la Boqueria",
"type": "Attraction",
"link": "https://www.tripadvisor.com/Attraction_Review-g187497-d190164-Reviews-Mercat_de_la_Boqueria-Barcelona_Province_of_Barcelona_Catalonia.html"
},
"reviews": [
{
"position": 1,
"id": 1056136683,
"title": "Worth a Visit, but Very Crowded",
"text": "Fun market with lots to see and buy. Great food at many of the stalls. Too crowded for my taste and we were constantly environmentally aware due to pickpockets. There are lots of interesting things to taste or buy here. The only complaint I have, other than the crowds, is that all of the tables are reserved for restaurant guests. We bought sandwiches and had to sit on some steps to enjoy them.",
"language": "en",
"original_language": "en",
"rating": 4,
"votes": 0,
"date": "2026-04-10",
"travel_date": "2026-04-30",
"travel_type": "Couples",
"publish_platform": "Other",
"link": "https://www.tripadvisor.com/ShowUserReviews-g187497-d190164-r1056136683-Mercat_de_la_Boqueria-Barcelona_Catalonia.html",
"author": {
"name": "FrequentTraveller034",
"username": "FrequentTraveller034",
"contributions": 625,
"hometown": "Marina del Rey, California",
"link": "https://www.tripadvisor.com/Profile/FrequentTraveller034",
"avatar": "https://dynamic-media-cdn.tripadvisor.com/media/photo-s/02/32/3d/9b/frequenttraveller034.jpg?w=550&h=412&s=1"
}
},
...
],
"pagination": {
"total_results": 27242,
"current_page": 1,
"next_page": 2
}
}
Reviews with text search
https://www.searchapi.io/api/v1/search?engine=tripadvisor_reviews&place_id=1465497&q=towels
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "tripadvisor_reviews",
"place_id": "1465497",
"q": "towels"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_parameters": {
"engine": "tripadvisor_reviews",
"place_id": "1465497",
"tripadvisor_domain": "tripadvisor.com",
"q": "towels",
"language": "en",
"translate": "true",
"num": 3,
"page": 1
},
"search_information": {
"total_reviews": 199,
"sort_by": "most_recent"
},
"place": {
"id": 1465497,
"title": "W Barcelona",
"type": "Accommodation",
"link": "https://www.tripadvisor.com/Hotel_Review-g187497-d1465497-Reviews-W_Barcelona-Barcelona_Catalonia.html"
},
"reviews": [
{
"position": 1,
"id": 1026428535,
"title": "Serious Security and Service Issues at W Barcelona",
"text": "During my stay at W Barcelona, I unfortunately experienced several incidents that left me very disappointed, especially considering this is a five-star hotel.\r\n\r\nWhen I first checked in, my luggage—which was right next to me at the reception desk—was stolen. Someone walked in, took it, and left. I had to spend my entire first day in Barcelona at the police station instead of enjoying my trip. What made the situation worse was that no one from the hotel contacted the police in advance or tried to facilitate the process, so I was left waiting for 2–3 hours just to file a report.\r\n\r\nThe main issue is that from the moment I arrived until I completed the check-in, no one assisted us with our luggage. If there had been proper staff to take care of the bags, provide tags, and ensure security, this would not have happened. For a hotel of this level, much more attention to guests’ safety and belongings is expected.\r\n\r\nEven basic service was disappointing: I requested a towel and a bathrobe, and more than three hours later, nothing was delivered. On another occasion, despite having the “Do Not Disturb” sign on my door, a member of housekeeping knocked and immediately opened the door, which made me feel very uncomfortable about privacy and security.\r\n\r\nThat being said, I would like to sincerely thank Peter, the hotel manager, who tried his best to ease the situation and showed genuine care in handling my case. His efforts were appreciated, but unfortunately they do not change the fact that such serious issues occurred in the first place.\r\n\r\nOverall, this was not the level of service, security, or professionalism I would ever expect from a W Hotel.",
"language": "en",
"original_language": "en",
"rating": 1,
"subratings": [
{
"text": "Value",
"value": 3
},
{
"text": "Rooms",
"value": 4
},
{
"text": "Location",
"value": 4
},
{
"text": "Cleanliness",
"value": 4
},
{
"text": "Service",
"value": 1
},
{
"text": "Sleep Quality",
"value": 2
}
],
"votes": 0,
"date": "2025-08-24",
"travel_date": "2025-08-31",
"travel_type": "Friends",
"publish_platform": "Other",
"link": "https://www.tripadvisor.com/ShowUserReviews-g187497-d1465497-r1026428535-W_Barcelona-Barcelona_Catalonia.html",
"author": {
"name": "Jassim Z",
"username": "Jz_8787",
"contributions": 14,
"hometown": "Kuwait City, Kuwait",
"link": "https://www.tripadvisor.com/Profile/Jz_8787",
"avatar": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/25/07/47/58/jassim-a.jpg?w=2268&h=2268&s=1"
},
"response": {
"text": "Dear Jz_8787,\nAlthough you are in direct contact with our General Manager, and everything is being followed up internally, I would like to extend our apologies for the reported incidents. \nIn regards to service, rest assured I will shared your comments with the Heads of the Departments involved in order to enure improvements are made.\nWe remain at your entire disposal.\nSincerely,\nSofia Silva\nDirector of Quality, W Barcelona",
"language": "en",
"date": "2025-08-30",
"author": {
"name": "Sofia S",
"link": "https://www.tripadvisor.com/Profile/X736VWsofias",
"avatar": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/f4/5d/default-avatar-2020-32.jpg?w=1200&h=1200&s=1",
"connection": "Other"
}
}
},
...
],
"pagination": {
"total_results": 199,
"current_page": 1,
"next_page": 2
}
}