TripAdvisor
Get the trip advisor, along with location details, comment and photos
This widget supports multiple actions. For a more comprehensive understanding of its functionality, we recommend reviewing the following documentation carefully.
You need to pass both the action and other input parameters of the chosen action to your module_config
Try it in the Widget Center
Click this url to try this widget and copy the Pro Config template.
Usage
Search Location by Query
action search_location
Input Parameters
Name
Type
Description
Default
Required
action
string
The action to perform. Valid options are 'search_location', 'location_details', 'location_reviews', 'location_photos', 'search_nearby_location'
search_location
query
string
Text to use for searching based on the name of the location
category
string
Filters result set based on property type. Valid options are "hotels", "attractions", "restaurants", and "geos"
hotels
phone
string
Phone number to filter the search results by (this can be in any format with spaces and dashes but without the "+" sign at the beginning)
address
string
Address to filter the search results by
lat_long
string
Latitude/Longitude pair to scope down the search around a specifc point - eg. "42.3455,-71.10767"
37.7749,-122.4194
radius
string
Length of the radius from the provided latitude/longitude pair to filter results.
radius_unit
string
Unit for length of the radius. Valid options are "km", "mi", "m" (km=kilometers, mi=miles, m=meters)
km
language
string
The language in which to return results (e.g. "en" for English or "es" for Spanish) from the list of our Supported Languages.
en
Output Parameters
Name
Type
Description
File Type
data
array
The data returned by the TripAdvisor
Output Example
{
"data": [
{
"address_obj": {
"address_string": "222 Mason St, San Francisco, CA 94102",
"city": "San Francisco",
"country": "United States",
"postalcode": "94102",
"state": "California",
"street1": "222 Mason St",
"street2": ""
},
"bearing": "northeast",
"distance": "0.9375039004167687",
"location_id": "80793",
"name": "Hotel Nikko San Francisco"
},
{
"address_obj": {
"address_string": "888 Howard Street, San Francisco, CA 94103-3011",
"city": "San Francisco",
"country": "United States",
"postalcode": "94103-3011",
"state": "California",
"street1": "888 Howard Street",
"street2": ""
},
"bearing": "northeast",
"distance": "0.9396498617003877",
"location_id": "676408",
"name": "InterContinental San Francisco"
},
{
"address_obj": {
"address_string": "1000 Pine St At Taylor Street, San Francisco, CA 94109-5032",
"city": "San Francisco",
"country": "United States",
"postalcode": "94109-5032",
"state": "California",
"street1": "1000 Pine St",
"street2": "At Taylor Street"
},
"bearing": "north",
"distance": "1.1700270366933818",
"location_id": "112355",
"name": "The Nob Hill Inn"
},
{
"address_obj": {
"address_string": "717 Battery St, San Francisco, CA 94111",
"city": "San Francisco",
"country": "United States",
"postalcode": "94111",
"state": "California",
"street1": "717 Battery St"
},
"bearing": "northeast",
"distance": "1.8779715266780468",
"location_id": "8459100",
"name": "The Battery"
},
{
"address_obj": {
"address_string": "205 Kentucky St, Petaluma, CA 94952",
"city": "Petaluma",
"country": "United States",
"postalcode": "94952",
"state": "California",
"street1": "205 Kentucky St"
},
"bearing": "north",
"distance": "34.11244717545214",
"location_id": "3836077",
"name": "Hotel Petaluma, Tapestry Collection by Hilton"
},
{
"address_obj": {
"address_string": "1350 Huntington Ave., San Bruno, CA 94066",
"city": "San Bruno",
"country": "United States",
"postalcode": "94066",
"state": "California",
"street1": "1350 Huntington Ave.",
"street2": ""
},
"bearing": "south",
"distance": "9.231291675933846",
"location_id": "225831",
"name": "Sonesta ES Suites San Francisco Airport San Bruno"
},
{
"address_obj": {
"address_string": "2515 El Camino Real, Santa Clara, CA 95051-3003",
"city": "Santa Clara",
"country": "United States",
"postalcode": "95051-3003",
"state": "California",
"street1": "2515 El Camino Real",
"street2": ""
},
"bearing": "southeast",
"distance": "38.15048052818919",
"location_id": "80061",
"name": "Granada Inn - Silicon Valley"
},
{
"address_obj": {
"address_string": "5415 Stevens Creek Blvd, Santa Clara, CA 95051-7202",
"city": "Santa Clara",
"country": "United States",
"postalcode": "95051-7202",
"state": "California",
"street1": "5415 Stevens Creek Blvd",
"street2": ""
},
"bearing": "southeast",
"distance": "38.6648908239683",
"location_id": "80063",
"name": "Woodcrest Hotel"
},
{
"address_obj": {
"address_string": "131 North St, Healdsburg, CA 95448-3821",
"city": "Healdsburg",
"country": "United States",
"postalcode": "95448-3821",
"state": "California",
"street1": "131 North St"
},
"bearing": "northwest",
"distance": "62.88299689714899",
"location_id": "11904247",
"name": "SingleThread Farm - Restaurant - Inn"
}
]
}Get Location Details
action location_details
Input Parameters
Name
Type
Description
Default
Required
action
string
The action to perform. Valid options are 'search_location', 'location_details', 'location_reviews', 'location_photos', 'search_nearby_location'
location_details
location_id
string
The location ID to get details for
language
string
The language in which to return results (e.g. "en" for English or "es" for Spanish) from the list of our Supported Languages.
en
currency
string
The currency code to use for request and response (should follow ISO 4217).
USD
Output Parameters
Name
Type
Description
File Type
data
array
The data returned by the TripAdvisor
Output Example
{
"data": [
{
"address_obj": {
"address_string": "222 Mason St, San Francisco, CA 94102",
"city": "San Francisco",
"country": "United States",
"postalcode": "94102",
"state": "California",
"street1": "222 Mason St",
"street2": ""
},
"amenities": [
"Non-smoking rooms",
"Internet",
"Suites",
"Wifi",
"Free Wifi",
"Wheelchair access",
"Spa",
"Hot Tub",
"Pool",
"Room service",
"Restaurant",
"Bar/Lounge",
"Pets Allowed",
"Airport transportation",
"Public Wifi",
"Dry Cleaning",
"Meeting rooms",
"Business center",
"Fitness center",
"Laundry Service",
"Concierge",
"Banquet Room",
"Air conditioning",
"Multilingual Staff",
"Accessible rooms",
"Refrigerator in room",
"Minibar",
"Conference Facilities",
"Non-smoking hotel",
"Safe",
"Heated pool",
"Flatscreen TV",
"Breakfast Buffet",
"Indoor pool",
"Parking",
"Facilities for Disabled Guests",
"Housekeeping",
"ATM On Site",
"Baggage Storage",
"Bath / Shower",
"Breakfast in the Room",
"English",
"Fitness / Spa Locker Rooms",
"Complimentary Toiletries",
"24-Hour Front Desk",
"Hair Dryer",
"Japanese",
"On-Demand Movies",
"Parking Garage",
"Pool / Beach Towels",
"Paid Private Parking On-site",
"Paid Private Parking Nearby",
"24-Hour Security",
"Secured Parking",
"Taxi Service",
"Car Hire",
"Currency Exchange",
"Evening Entertainment",
"Kids' Meals",
"Nightclub / DJ",
"Patio",
"Shallow End",
"Valet Parking",
"Walk-in Shower",
"Beach Access"
],
"ancestors": [
{
"level": "City",
"location_id": "60713",
"name": "San Francisco"
},
{
"abbrv": "CA",
"level": "State",
"location_id": "28926",
"name": "California"
},
{
"level": "Country",
"location_id": "191",
"name": "United States"
}
],
"awards": [
{
"award_type": "Travelers Choice",
"categories": [],
"display_name": "Travelers Choice",
"images": {
"large": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2024_L.png",
"small": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2024_L.png",
"tiny": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2024_L.png"
},
"year": "2024"
},
{
"award_type": "Travelers Choice",
"categories": [],
"display_name": "Travelers Choice",
"images": {
"large": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2023_L.png",
"small": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2023_L.png",
"tiny": "https://static.tacdn.com/img2/travelers_choice/widgets/tchotel_2023_L.png"
},
"year": "2023"
}
],
"brand": "Preferred Hotels \u0026 Resorts",
"category": {
"localized_name": "Hotel",
"name": "hotel"
},
"description": "Retreat to Hotel Nikko in San Francisco, where personalized service meets cutting-edge style. Our hotel is set in the heart of the city, just steps from Union Square shops and restaurants, making it the ideal destination for both business and leisure travel. Our four-diamond rated property features 532 guest rooms and 22 suites, each with pillow-top beds, high-speed internet, and a wealth of modern amenities.",
"latitude": "37.785847",
"location_id": "80793",
"longitude": "-122.409294",
"name": "Hotel Nikko San Francisco",
"neighborhood_info": [
{
"location_id": "7222631",
"name": "Union Square"
},
{
"location_id": "15622015",
"name": "Downtown San Francisco"
},
{
"location_id": "15621924",
"name": "Tenderloin"
},
{
"location_id": "15622020",
"name": "Theater District"
}
],
"num_reviews": "4730",
"parent_brand": "Preferred Hotel Group",
"phone": "14153196761",
"photo_count": "1360",
"price_level": "$$$",
"ranking_data": {
"geo_location_id": "60713",
"geo_location_name": "San Francisco",
"ranking": "39",
"ranking_out_of": "254",
"ranking_string": "#39 of 254 hotels in San Francisco"
},
"rating": "4.0",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-66827-5.svg",
"review_rating_count": {
"1": "142",
"2": "177",
"3": "524",
"4": "1645",
"5": "2243"
},
"see_all_photos": "https://www.tripadvisor.com/Hotel_Review-g60713-d80793-m66827-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html#photos",
"styles": [
"Green",
"Family"
],
"subcategory": [
{
"localized_name": "Hotel",
"name": "hotel"
}
],
"subratings": {
"0": {
"localized_name": "Location",
"name": "rate_location",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.5.svg",
"value": "4.5"
},
"1": {
"localized_name": "Sleep Quality",
"name": "rate_sleep",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.5.svg",
"value": "4.5"
},
"2": {
"localized_name": "Rooms",
"name": "rate_room",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.0.svg",
"value": "4.0"
},
"3": {
"localized_name": "Service",
"name": "rate_service",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.5.svg",
"value": "4.5"
},
"4": {
"localized_name": "Value",
"name": "rate_value",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.0.svg",
"value": "4.0"
},
"5": {
"localized_name": "Cleanliness",
"name": "rate_cleanliness",
"rating_image_url": "https://static.tacdn.com/img2/ratings/traveler/ss4.5.svg",
"value": "4.5"
}
},
"timezone": "America/Los_Angeles",
"trip_types": [
{
"localized_name": "Business",
"name": "business",
"value": "1229"
},
{
"localized_name": "Couples",
"name": "couples",
"value": "1576"
},
{
"localized_name": "Solo travel",
"name": "solo",
"value": "274"
},
{
"localized_name": "Family",
"name": "family",
"value": "787"
},
{
"localized_name": "Friends getaway",
"name": "friends",
"value": "303"
}
],
"web_url": "https://www.tripadvisor.com/Hotel_Review-g60713-d80793-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827",
"write_review": "https://www.tripadvisor.com/UserReview-g60713-d80793-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827"
}
]
}
Get Location Reviews
action location_reviews
Input Parameters
Name
Type
Description
Default
Required
action
string
The action to perform. Valid options are 'search_location', 'location_details', 'location_reviews', 'location_photos', 'search_nearby_location
location_reviews
location_id
string
The location ID to get details for
language
string
The language in which to return results (e.g. "en" for English or "es" for Spanish) from the list of our Supported Languages.
en
limit
integer
The number of reviews to return
5
offset
integer
The number of reviews to skip
0
Output Parameters
Name
Type
Description
File Type
data
array
The data returned by the TripAdvisor
Output Example
{
"data": [
{
"id": 948421388,
"lang": "en",
"location_id": 80793,
"published_date": "2024-04-26T20:32:44Z",
"rating": 5,
"helpful_votes": 0,
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60713-d80793-r948421388-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827#review948421388",
"text": "We went to several hotels over three weeks during our trip to the West Coast and this was my favourite room by far and we did stay in really lovely hotels! The room was comfortable, clean, cosy and had every mod con ie USB ports by the bed and had the most fantastic toilet I’ve ever seen in my life when you walked into the bathroom the toilet started cleaning itself before you even sat down and had a heated seat and even a remote control too 🤪 the hotel was in a superb central location, staff were friendly and helpful. Not that we had any reason to speak to them very much and I’m delighted that we picked this hotel.",
"title": "Fabulous hotel in Central location",
"trip_type": "Couples",
"travel_date": "2024-04-30",
"user": {
"username": "t4nse",
"user_location": {
"id": "672161",
"name": "Borehamwood, Hertfordshire, England"
},
"avatar": {
"thumbnail": "https://media-cdn.tripadvisor.com/media/photo-t/1c/60/5c/11/avatar.jpg",
"small": "https://media-cdn.tripadvisor.com/media/photo-l/1c/60/5c/11/avatar.jpg",
"medium": "https://media-cdn.tripadvisor.com/media/photo-f/1c/60/5c/11/avatar.jpg",
"large": "https://media-cdn.tripadvisor.com/media/photo-s/1c/60/5c/11/avatar.jpg"
}
},
"subratings": {}
},
{
"id": 947997768,
"lang": "en",
"location_id": 80793,
"published_date": "2024-04-23T12:57:57Z",
"rating": 5,
"helpful_votes": 0,
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60713-d80793-r947997768-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827#review947997768",
"text": "Wonderful hotel. Rooms were very comfortable. Shower and toilet were a little confusing (shower fixture and electric toilet). But enjoyed my stay. Lots of places to eat and a block away from the cable car and other transportation. Hotel is in an overall good location but we were cautioned about certain streets. But I felt safe the whole time.",
"title": "Conference attendance",
"trip_type": "Business",
"travel_date": "2024-04-30",
"user": {
"username": "994germaine",
"user_location": {
"id": "null"
},
"avatar": {
"thumbnail": "https://media-cdn.tripadvisor.com/media/photo-t/1a/f6/e4/a9/default-avatar-2020-50.jpg",
"small": "https://media-cdn.tripadvisor.com/media/photo-l/1a/f6/e4/a9/default-avatar-2020-50.jpg",
"medium": "https://media-cdn.tripadvisor.com/media/photo-f/1a/f6/e4/a9/default-avatar-2020-50.jpg",
"large": "https://media-cdn.tripadvisor.com/media/photo-p/1a/f6/e4/a9/default-avatar-2020-50.jpg",
"original": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e4/a9/default-avatar-2020-50.jpg"
}
},
"subratings": {
"0": {
"name": "RATE_VALUE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Value"
},
"1": {
"name": "RATE_ROOM",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Rooms"
},
"2": {
"name": "RATE_LOCATION",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s4.0-66827-5.svg",
"value": 4,
"localized_name": "Location"
},
"3": {
"name": "RATE_CLEANLINESS",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Cleanliness"
},
"4": {
"name": "RATE_SERVICE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Service"
},
"5": {
"name": "RATE_SLEEP",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Sleep Quality"
}
},
"owner_response": {
"id": 948025528,
"title": "Owner response",
"text": "Good Day,\nThank you for taking the time to submit a review of your recent stay at the Hotel Nikko San Francisco. Your feedback is essential in helping the team at the hotel Nikko to offer a service that promotes Fantastic Memories. We are delighted to hear that you enjoyed your stay, and we are looking forward to welcoming you back to the Hotel Nikko upon a future trip to San Francisco. Please do not hesitate to contact us if there is anything the team can do to make your next trip memorable.\nSincerely, The Quality Assurance and Guest Experience Team",
"lang": "en",
"author": "Philippe Striffeler",
"published_date": "2024-04-23T17:19:58Z"
}
},
{
"id": 947873358,
"lang": "en",
"location_id": 80793,
"published_date": "2024-04-22T13:23:51Z",
"rating": 5,
"helpful_votes": 0,
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60713-d80793-r947873358-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827#review947873358",
"text": "Our stay starts at arrival with a warm welcome by an attentive doorman and bellman. The bellman hands you a card to pass on to the desk reception and directs you to an escalator up to reception. At reception you are efficiently identified and charged the customary fees up front and within seconds you are on your way to your room and your bags are delivered minutes later.\n\nThe space was clean, quiet, comfortable with a Zen like experience intended to evoke calmness to your senses. Did I mention clean? There are no odd odors. You have a sitting area, comfortable bed, dual environmental controls, separate shower and tub in the bath, and reusable water bottles with access to filtered water next to the floor's ice machine. There is one annoyance. The bidet \"recycles\" about 30 seconds after use. In a space you could hear a pin drop it is curious to hear it for the 1st time after returning to bed. Not a biggie. Remember there are no background city noises.\n\nRoom service. The hallmark of only the finest hotels. An excellent breakfast delivered within the minutes you have requested it is the ultimate start of your day. White linen wrapped toast anyone?\n\nOn leaving, ask the desk for a bag pickup and the bill preparation and there are no surprises if you pay attention with what you have charged the room on checkout.\n\nEvery request I made was answered and ended with \"Is there anything else you require?\" You can spend less and far more for accommodations but not certain it can get any better.",
"title": "A quiet serene stay on the 20th floor in a corner space.",
"trip_type": "NONE",
"travel_date": "2024-04-30",
"user": {
"username": "edwardlB50JR",
"user_location": {
"id": "null"
},
"avatar": {
"thumbnail": "https://media-cdn.tripadvisor.com/media/photo-t/1a/f6/f0/9f/default-avatar-2020-16.jpg",
"small": "https://media-cdn.tripadvisor.com/media/photo-l/1a/f6/f0/9f/default-avatar-2020-16.jpg",
"medium": "https://media-cdn.tripadvisor.com/media/photo-f/1a/f6/f0/9f/default-avatar-2020-16.jpg",
"large": "https://media-cdn.tripadvisor.com/media/photo-p/1a/f6/f0/9f/default-avatar-2020-16.jpg",
"original": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f0/9f/default-avatar-2020-16.jpg"
}
},
"subratings": {
"0": {
"name": "RATE_VALUE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Value"
},
"1": {
"name": "RATE_ROOM",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Rooms"
},
"2": {
"name": "RATE_LOCATION",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Location"
},
"3": {
"name": "RATE_CLEANLINESS",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Cleanliness"
},
"4": {
"name": "RATE_SERVICE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Service"
},
"5": {
"name": "RATE_SLEEP",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Sleep Quality"
}
},
"owner_response": {
"id": 948025515,
"title": "Owner response",
"text": "Good Day,\nThank you for taking the time to submit a review of your recent stay at the Hotel Nikko San Francisco. Your feedback is essential in helping the team at the hotel Nikko to offer a service that promotes Fantastic Memories. We are delighted to hear that you enjoyed your stay, and we are looking forward to welcoming you back to the Hotel Nikko upon a future trip to San Francisco. Please do not hesitate to contact us if there is anything the team can do to make your next trip memorable.\nSincerely, The Quality Assurance and Guest Experience Team",
"lang": "en",
"author": "Philippe Striffeler",
"published_date": "2024-04-23T17:19:45Z"
}
},
{
"id": 947729492,
"lang": "en",
"location_id": 80793,
"published_date": "2024-04-21T13:54:36Z",
"rating": 5,
"helpful_votes": 0,
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60713-d80793-r947729492-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827#review947729492",
"text": "Wonderful stay on Imperial floor. Luis in Imperial Lounge at breakfast provided extraordinary service and made each guest feel like family. Room was quiet with glorious view. Beautiful design including a magnificent Japanese type design bathroom with both fabulous shower and a separate tub. Housekeeping was equally top notch as well as concierge. Thank you for a restful stay. Also we liking Durance to SFMOMA and to a range of restaurants. A top notch stay. Can’t wait to return!!",
"title": "Outstanding stay & outstanding service!!!",
"trip_type": "Solo travel",
"travel_date": "2024-03-31",
"user": {
"username": "830nanettel",
"user_location": {
"id": "41003",
"name": "Bethesda, Montgomery County, Maryland"
},
"avatar": {
"thumbnail": "https://media-cdn.tripadvisor.com/media/photo-t/1a/f6/e5/66/default-avatar-2020-53.jpg",
"small": "https://media-cdn.tripadvisor.com/media/photo-l/1a/f6/e5/66/default-avatar-2020-53.jpg",
"medium": "https://media-cdn.tripadvisor.com/media/photo-f/1a/f6/e5/66/default-avatar-2020-53.jpg",
"large": "https://media-cdn.tripadvisor.com/media/photo-p/1a/f6/e5/66/default-avatar-2020-53.jpg",
"original": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e5/66/default-avatar-2020-53.jpg"
}
},
"subratings": {
"0": {
"name": "RATE_VALUE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s4.0-66827-5.svg",
"value": 4,
"localized_name": "Value"
},
"1": {
"name": "RATE_ROOM",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Rooms"
},
"2": {
"name": "RATE_CLEANLINESS",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Cleanliness"
},
"3": {
"name": "RATE_SERVICE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Service"
},
"4": {
"name": "RATE_SLEEP",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Sleep Quality"
}
},
"owner_response": {
"id": 947858026,
"title": "Owner response",
"text": "Good Day,\nThank you for taking the time to submit a review of your recent stay at the Hotel Nikko San Francisco. Your feedback is essential in helping the team at the hotel Nikko to offer a service that promotes Fantastic Memories. We are delighted to hear that you enjoyed your stay, and we are looking forward to welcoming you back to the Hotel Nikko upon a future trip to San Francisco. Please do not hesitate to contact us if there is anything the team can do to make your next trip memorable.\nSincerely, The Quality Assurance and Guest Experience Team",
"lang": "en",
"author": "Philippe Striffeler",
"published_date": "2024-04-22T11:27:15Z"
}
},
{
"id": 947701022,
"lang": "en",
"location_id": 80793,
"published_date": "2024-04-21T10:26:44Z",
"rating": 5,
"helpful_votes": 0,
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60713-d80793-r947701022-Reviews-Hotel_Nikko_San_Francisco-San_Francisco_California.html?m=66827#review947701022",
"text": "This was a great hotel. I had never been to the area and was a little overwhelmed. Every front desk employee helped me in some way that made our trip a success (from sushi recommendations to navigating the public transportation system). I just wish the location was a little closer to fisherman’s wharf. It’s not walking distance. ",
"title": "Great hotel!",
"trip_type": "NONE",
"travel_date": "2024-04-30",
"user": {
"username": "jfrombos2n",
"user_location": {
"id": "60745",
"name": "Boston, Massachusetts"
},
"avatar": {
"thumbnail": "https://media-cdn.tripadvisor.com/media/photo-t/1a/f6/e2/11/default-avatar-2020-41.jpg",
"small": "https://media-cdn.tripadvisor.com/media/photo-l/1a/f6/e2/11/default-avatar-2020-41.jpg",
"medium": "https://media-cdn.tripadvisor.com/media/photo-f/1a/f6/e2/11/default-avatar-2020-41.jpg",
"large": "https://media-cdn.tripadvisor.com/media/photo-p/1a/f6/e2/11/default-avatar-2020-41.jpg",
"original": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/e2/11/default-avatar-2020-41.jpg"
}
},
"subratings": {
"0": {
"name": "RATE_VALUE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Value"
},
"1": {
"name": "RATE_ROOM",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Rooms"
},
"2": {
"name": "RATE_LOCATION",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s3.0-66827-5.svg",
"value": 3,
"localized_name": "Location"
},
"3": {
"name": "RATE_CLEANLINESS",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Cleanliness"
},
"4": {
"name": "RATE_SERVICE",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Service"
},
"5": {
"name": "RATE_SLEEP",
"rating_image_url": "https://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/s5.0-66827-5.svg",
"value": 5,
"localized_name": "Sleep Quality"
}
},
"owner_response": {
"id": 947857992,
"title": "Owner response",
"text": "Good Day,\nThank you for taking the time to submit a review of your recent stay at the Hotel Nikko San Francisco. Your feedback is essential in helping the team at the hotel Nikko to offer a service that promotes Fantastic Memories. We are delighted to hear that you enjoyed your stay, and we are looking forward to welcoming you back to the Hotel Nikko upon a future trip to San Francisco. Please do not hesitate to contact us if there is anything the team can do to make your next trip memorable.\nSincerely, The Quality Assurance and Guest Experience Team",
"lang": "en",
"author": "Philippe Striffeler",
"published_date": "2024-04-22T11:27:02Z"
}
}
]
}Get Location Photos
action location_photos
Input Parameters
Name
Type
Description
Default
Required
action
string
The action to perform. Valid options are 'search_location', 'location_details', 'location_reviews', 'location_photos', 'search_nearby_location'
location_photos
location_id
string
The location ID to get details for
language
string
The language in which to return results (e.g. "en" for English or "es" for Spanish) from the list of our Supported Languages.
en
limit
integer
The number of reviews to return
5
offset
integer
The number of reviews to skip
0
source
string
A comma-separated list of allowed photo sources. Allowed values are 'Expert', 'Management', 'Traveler'. If not specified, allow photos from all sources.
Output Parameters
Name
Type
Description
File Type
data
array
The data returned by the TripAdvisor
Output Example
{
"data": [
{
"id": 375086664,
"is_blessed": false,
"caption": "Very spacious room",
"published_date": "2019-02-05T04:07:52.357Z",
"images": {
"thumbnail": {
"height": 50,
"width": 50,
"url": "https://media-cdn.tripadvisor.com/media/photo-t/16/5b/5e/48/very-spacious-room.jpg"
},
"small": {
"height": 150,
"width": 150,
"url": "https://media-cdn.tripadvisor.com/media/photo-l/16/5b/5e/48/very-spacious-room.jpg"
},
"medium": {
"height": 188,
"width": 250,
"url": "https://media-cdn.tripadvisor.com/media/photo-f/16/5b/5e/48/very-spacious-room.jpg"
},
"large": {
"height": 413,
"width": 550,
"url": "https://media-cdn.tripadvisor.com/media/photo-s/16/5b/5e/48/very-spacious-room.jpg"
},
"original": {
"height": 960,
"width": 1280,
"url": "https://media-cdn.tripadvisor.com/media/photo-m/1280/16/5b/5e/48/very-spacious-room.jpg"
}
},
"album": "Room/Suite",
"source": {
"name": "Traveler",
"localized_name": "Traveler"
},
"user": {
"username": "MaiCho"
}
},
{
"id": 136507173,
"is_blessed": false,
"caption": "Exterior",
"published_date": "2015-06-19T19:57:30.207Z",
"images": {
"thumbnail": {
"height": 50,
"width": 50,
"url": "https://media-cdn.tripadvisor.com/media/photo-t/08/22/ef/25/hotel-nikko-san-francisco.jpg"
},
"small": {
"height": 150,
"width": 150,
"url": "https://media-cdn.tripadvisor.com/media/photo-l/08/22/ef/25/hotel-nikko-san-francisco.jpg"
},
"medium": {
"height": 104,
"width": 250,
"url": "https://media-cdn.tripadvisor.com/media/photo-f/08/22/ef/25/hotel-nikko-san-francisco.jpg"
},
"large": {
"height": 227,
"width": 550,
"url": "https://media-cdn.tripadvisor.com/media/photo-s/08/22/ef/25/hotel-nikko-san-francisco.jpg"
},
"original": {
"height": 424,
"width": 1024,
"url": "https://media-cdn.tripadvisor.com/media/photo-w/08/22/ef/25/hotel-nikko-san-francisco.jpg"
}
},
"album": "Other",
"source": {
"name": "Management",
"localized_name": "Management"
},
"user": {
"username": "Management"
}
},
{
"id": 273934067,
"is_blessed": false,
"caption": "Front Desk",
"published_date": "2017-08-18T17:17:02.127Z",
"images": {
"thumbnail": {
"height": 50,
"width": 50,
"url": "https://media-cdn.tripadvisor.com/media/photo-t/10/53/e6/f3/front-desk.jpg"
},
"small": {
"height": 150,
"width": 150,
"url": "https://media-cdn.tripadvisor.com/media/photo-l/10/53/e6/f3/front-desk.jpg"
},
"medium": {
"height": 168,
"width": 250,
"url": "https://media-cdn.tripadvisor.com/media/photo-f/10/53/e6/f3/front-desk.jpg"
},
"large": {
"height": 370,
"width": 550,
"url": "https://media-cdn.tripadvisor.com/media/photo-s/10/53/e6/f3/front-desk.jpg"
},
"original": {
"height": 1346,
"width": 2000,
"url": "https://media-cdn.tripadvisor.com/media/photo-o/10/53/e6/f3/front-desk.jpg"
}
},
"album": "Hotel & Grounds",
"source": {
"name": "Management",
"localized_name": "Management"
},
"user": {
"username": "Management"
}
},
{
"id": 273933546,
"is_blessed": false,
"caption": "Lobby",
"published_date": "2017-08-18T17:14:37.396Z",
"images": {
"thumbnail": {
"height": 50,
"width": 50,
"url": "https://media-cdn.tripadvisor.com/media/photo-t/10/53/e4/ea/lobby.jpg"
},
"small": {
"height": 150,
"width": 150,
"url": "https://media-cdn.tripadvisor.com/media/photo-l/10/53/e4/ea/lobby.jpg"
},
"medium": {
"height": 168,
"width": 250,
"url": "https://media-cdn.tripadvisor.com/media/photo-f/10/53/e4/ea/lobby.jpg"
},
"large": {
"height": 370,
"width": 550,
"url": "https://media-cdn.tripadvisor.com/media/photo-s/10/53/e4/ea/lobby.jpg"
},
"original": {
"height": 1347,
"width": 2000,
"url": "https://media-cdn.tripadvisor.com/media/photo-o/10/53/e4/ea/lobby.jpg"
}
},
"album": "Hotel & Grounds",
"source": {
"name": "Management",
"localized_name": "Management"
},
"user": {
"username": "Management"
}
},
{
"id": 273933541,
"is_blessed": false,
"caption": "Deluxe Queen Room",
"published_date": "2017-08-18T17:14:34.191Z",
"images": {
"thumbnail": {
"height": 50,
"width": 50,
"url": "https://media-cdn.tripadvisor.com/media/photo-t/10/53/e4/e5/deluxe-queen-room.jpg"
},
"small": {
"height": 150,
"width": 150,
"url": "https://media-cdn.tripadvisor.com/media/photo-l/10/53/e4/e5/deluxe-queen-room.jpg"
},
"medium": {
"height": 166,
"width": 250,
"url": "https://media-cdn.tripadvisor.com/media/photo-f/10/53/e4/e5/deluxe-queen-room.jpg"
},
"large": {
"height": 364,
"width": 550,
"url": "https://media-cdn.tripadvisor.com/media/photo-s/10/53/e4/e5/deluxe-queen-room.jpg"
},
"original": {
"height": 1325,
"width": 2000,
"url": "https://media-cdn.tripadvisor.com/media/photo-o/10/53/e4/e5/deluxe-queen-room.jpg"
}
},
"album": "Room/Suite",
"source": {
"name": "Management",
"localized_name": "Management"
},
"user": {
"username": "Management"
}
}
]
}Search Nearby Location
action search_nearby_location
Input Parameters
Name
Type
Description
Default
Required
action
string
The action to perform. Valid options are 'search_location', 'location_details', 'location_reviews', 'location_photos', 'search_nearby_location'
search_nearby_location
lat_long
string
Latitude/Longitude pair to scope down the search around a specifc point - eg. "42.3455,-71.10767"
37.7749,-122.4194
category
string
Filters result set based on property type. Valid options are "hotels", "attractions", "restaurants", and "geos"
hotels
phone
string
Phone number to filter the search results by (this can be in any format with spaces and dashes but without the "+" sign at the beginning)
address
string
Address to filter the search results by
radius
string
Length of the radius from the provided latitude/longitude pair to filter results.
radius_unit
string
Unit for length of the radius. Valid options are "km", "mi", "m" (km=kilometers, mi=miles, m=meters)
km
language
string
The language in which to return results (e.g. "en" for English or "es" for Spanish) from the list of our Supported Languages.
en
Output Parameters
Name
Type
Description
File Type
data
array
The data returned by the TripAdvisor
Output Example
{
"data": [
{
"location_id": "25981377",
"name": "Golden Gate Hall",
"distance": "0.11813290781976289",
"bearing": "northeast",
"address_obj": {
"street1": "1412 Market Street",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102",
"address_string": "1412 Market Street, San Francisco, CA 94102"
}
},
{
"location_id": "81136",
"name": "Inn@Market",
"distance": "0.11819927029229718",
"bearing": "northeast",
"address_obj": {
"street1": "1412 Market St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-6004",
"address_string": "1412 Market St, San Francisco, CA 94102-6004"
}
},
{
"location_id": "142261",
"name": "SOMA Park Inn - Civic Center",
"distance": "0.28332372268907535",
"bearing": "east",
"address_obj": {
"street1": "101 9th St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94103-2602",
"address_string": "101 9th St, San Francisco, CA 94103-2602"
}
},
{
"location_id": "81035",
"name": "BEI San Francisco, Trademark Collection by Wyndham",
"distance": "0.34469649678886094",
"bearing": "northeast",
"address_obj": {
"street1": "50 8th St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94103-1409",
"address_string": "50 8th St, San Francisco, CA 94103-1409"
}
},
{
"location_id": "81782",
"name": "Edwardian Hotel",
"distance": "0.1561006911946066",
"bearing": "southwest",
"address_obj": {
"street1": "1668 Market St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-5949",
"address_string": "1668 Market St, San Francisco, CA 94102-5949"
}
},
{
"location_id": "1223830",
"name": "San Francisco Central Hotel",
"distance": "0.2546225845551202",
"bearing": "southwest",
"address_obj": {
"street1": "1707 Market St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94103-1218",
"address_string": "1707 Market St, San Francisco, CA 94103-1218"
}
},
{
"location_id": "80753",
"name": "Inn On Grove - San Francisco Civic Center",
"distance": "0.3140788375767515",
"bearing": "northwest",
"address_obj": {
"street1": "465 Grove St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-4302",
"address_string": "465 Grove St, San Francisco, CA 94102-4302"
}
},
{
"location_id": "20063299",
"name": "Abigail Hotel",
"distance": "0.452152912500969",
"bearing": "northeast",
"address_obj": {
"street1": "246 McAllister St",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-4707",
"address_string": "246 McAllister St, San Francisco, CA 94102-4707"
}
},
{
"location_id": "80766",
"name": "The Embassy Hotel",
"distance": "0.5165878513316494",
"bearing": "north",
"address_obj": {
"street1": "610 Polk St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-3328",
"address_string": "610 Polk St, San Francisco, CA 94102-3328"
}
},
{
"location_id": "224956",
"name": "Inn at the Opera",
"distance": "0.3083844068702081",
"bearing": "northwest",
"address_obj": {
"street1": "333 Fulton St",
"street2": "",
"city": "San Francisco",
"state": "California",
"country": "United States",
"postalcode": "94102-4423",
"address_string": "333 Fulton St, San Francisco, CA 94102-4423"
}
}
]
}Last updated