/travel_guide (search)

Call the API with the unique ID for a destination.  The response provides a list of travel guides for that destination. Each travel guide in the list includes associated metadata such as: guide type, guide audience, and publish date. Making a subsequent call to the API using a particular guide's unique identifier will return the POIs, recommendations, and tips for that guide.

Request

http://api.tripadvisor.com/api/partner/2.0/travel_guide?key=PARTNER_KEY&geo_id=60745

Query Parameters

Name Description
geo_id The unique identifier for the destination (i.e., 60745 is the geo_id for Boston, Massachusetts). The partner's ID can be used for this parameter, if there is a mapping.
lang The desired language locale. Valid values are: en_US, en_UK, en_SG, en_AU, en_IE, en_IN, en_MY.
guide_type Filters result set by type of travel guide. Valid values are: 1_day, 3_day, or general.
guide_audience Filters result set by target audience that the guide is intended for. Valid values are: Everyone, Solo, Friends, Couples, Senior, Family.
 

Response

{
  "data": {
    "guide_list": [
      {
        "guide_type": "3_day",
        "guide_audience": [
          {
            "name": "everyone",
            "localized_name": "Everyone"
          }
        ],
        "guide_id": "60745_166",
        "guide_title": "3 Days in Boston",
        "publish_date": "2014-11-17",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "97%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k166-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_166?key=InternalFull"
      },
      {
        "guide_type": "1_day",
        "guide_audience": [
          {
            "name": "family",
            "localized_name": "Family"
          }
        ],
        "guide_id": "60745_167",
        "guide_title": "Guide to Boston for Families",
        "publish_date": "2014-11-13",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "97%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k167-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_167?key=InternalFull"
      },
      {
        "guide_type": "general",
        "guide_audience": [
          {
            "name": "everyone",
            "localized_name": "Everyone"
          }
        ],
        "guide_id": "60745_193",
        "guide_title": "Guide to Boston Outdoors",
        "publish_date": "2014-11-12",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "94%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k193-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_193?key=InternalFull"
      },
      {
        "guide_type": "general",
        "guide_audience": [
          {
            "name": "everyone",
            "localized_name": "Everyone"
          }
        ],
        "guide_id": "60745_175",
        "guide_title": "Boston Off the Beaten Path",
        "publish_date": "2014-11-14",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "88%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k175-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_175?key=InternalFull"
      },
      {
        "guide_type": "general",
        "guide_audience": [
          {
            "name": "couples",
            "localized_name": "Couples"
          }
        ],
        "guide_id": "60745_160",
        "guide_title": "Romantic Guide to Boston",
        "publish_date": "2014-11-12",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "88%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k160-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_160?key=InternalFull"
      },
      {
        "guide_type": "general",
        "guide_audience": [
          {
            "name": "everyone",
            "localized_name": "Everyone"
          }
        ],
        "guide_id": "60745_189",
        "guide_title": "Best Food in Boston",
        "publish_date": "2014-11-17",
        "geo_location_id": "60745",
        "geo_location_name": "Boston",
        "helpful_vote": "85%",
        "guide_url": "https://www.tripadvisor.com/Guide-g60745-k189-Boston_Massachusetts.html",
        "api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/travel_guide/60745_189?key=InternalFull"
      }
    ],
    "guide_list_url": "https://www.tripadvisor.com/Travel_Guide-g60745-Boston_Massachusetts.html"
  },
  "paging": {
    "next": null,
    "previous": null,
    "results": "6",
    "total_results": "6",
    "skipped": "0"
  }
}

Properties

Field Type Description
guide_type string Describes whether the travel guide uses a 1-day, 3-day or general itinerary.
guide_audience string The intended target audience of the travel guide. Valid values are: Everyone, Solo, Friends, Couples, Senior, Family.
guide_id string

The unique identifier for a given travel guide.

 
guide_title string The name of the travel guide.
publish_date date The date when the travel guide was published.
geo_location_id string The unique Tripadvisor ID for the destination (i.e., 60745 is the geo_id for Boston, Massachusetts).
geo_location_name string The name of the destination.
helpful_vote string Tripadvisor users can vote a travel guide as helpful. This number represents the percentage of users that found a travel guide to be helpful (i.e., 98%).
api_detail_url string Link to the API url that returns the details and associated POIs for one individual travel guide in the list.
paging object Information required to browse the next and previous sets of locations in the list, if they were not all returned as part of the current call.
 

Connections

Name Description
detail Returns metadata and details about each POI in a given travel guide.