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

NameTypeDescriptionDefaultRequired

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

NameTypeDescriptionFile 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

NameTypeDescriptionDefaultRequired

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

NameTypeDescriptionFile 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

NameTypeDescriptionDefaultRequired

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

NameTypeDescriptionFile 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

NameTypeDescriptionDefaultRequired

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

NameTypeDescriptionFile 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

NameTypeDescriptionDefaultRequired

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

NameTypeDescriptionFile 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