Call the API with the unique ID for a particular travel guide. The response provides detail about the selected guide, including metadata and a list of POIs as chosen by the travel guide author.
| Name | Description |
|---|---|
| lang | The desired language locale. Valid values are: en_US, en_UK, en_SG, en_AU, en_IE, en_IN, en_MY. |
{
"data": {
"guide": {
"guide_type": "1_day",
"guide_id": "60745_167",
"guide_title": "Guide to Boston for Families",
"publish_date": "2014-11-13",
"guide_audience": [
{
"name": "family",
"localized_name": "Family"
}
],
"traveler_type": [
{
"name": "foodie",
"localized_name": "Foodie"
},
{
"name": "thrifty_traveler",
"localized_name": "Thrifty Traveler"
},
{
"name": "history_buff",
"localized_name": "History Buff"
},
{
"name": "nature_lover",
"localized_name": "Nature Lover"
}
],
"guide_description": "From educational activities to outdoor spaces perfect for letting off steam, Boston offers a wealth of opportunities for family fun. Here are the top spots that kids big and small can enjoy together.",
"guide_tips": [
{
"tip": "Avoid driving as much as possible; parking is expensive! Boston is a very \"walkable\" city, and the subway (\"The T\") is easy to use. There are also plenty of cabs and buses."
},
{
"tip": "Instead of buying a paper transit ticket from one of the machines, ask an attendant for a Charlie Card, which you can load with money – it ends up cheaper."
},
{
"tip": "Locals say, \"If you don't like the weather, wait a minute...it will change!\" It could be hot, humid, cold, sunny, rainy or snowy (sometimes in a day!) so pack sunscreen and layers."
},
{
"tip": "Many sidewalks are brick and cobblestone. Sneakers or other flat walking shoes are recommended."
},
{
"tip": "Boston caters to all tastes and budgets, from gourmet to street food."
},
{
"tip": "Neighborhoods (and cuisines) include: North End (Italian), Chinatown (Asian), South Boston (Ethnic), downtown (Pubs and Taverns), and Newbury Street/Back Bay (Trendy, Upscale)."
},
{
"tip": "Tip 15-20% at sit-down restaurants."
}
],
"guide_url": "https://www.tripadvisor.com/Guide-g60745-k167-Boston_Massachusetts.html",
"geo_location_id": "60745",
"geo_location_name": "Boston"
},
"items": {
"guide_poi": [
{
"poi_name": "Boston Public Garden",
"day": "Day 1",
"poi_photos": [
{
"small": {
"height": "412",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/02/79/d1/94/fall-colors.jpg"
},
"medium": {
"height": "187",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/02/79/d1/94/fall-colors.jpg"
},
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/02/79/d1/94/fall-colors.jpg"
},
"large": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/02/79/d1/94/fall-colors.jpg"
}
},
{
"original": {
"height": "2672",
"width": "4000",
"url": "http://media-cdn.tripadvisor.com/media/photo-o/03/f6/00/80/swan-boats.jpg"
},
"small": {
"height": "367",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/03/f6/00/80/swan-boats.jpg"
},
"medium": {
"height": "167",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/03/f6/00/80/swan-boats.jpg"
},
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/03/f6/00/80/swan-boats.jpg"
},
"large": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/03/f6/00/80/swan-boats.jpg"
}
},
{
"original": {
"height": "1500",
"width": "2000",
"url": "http://media-cdn.tripadvisor.com/media/photo-o/03/f4/ff/16/boston-public-garden.jpg"
},
"small": {
"height": "412",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/03/f4/ff/16/boston-public-garden.jpg"
},
"medium": {
"height": "187",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/03/f4/ff/16/boston-public-garden.jpg"
},
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/03/f4/ff/16/boston-public-garden.jpg"
},
"large": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/03/f4/ff/16/boston-public-garden.jpg"
}
}
],
"poi_recommendation": "The beautiful Boston Public Garden is part of Boston Common and is lovely any time of year. You can bike or stroll along its paths, past flowers, gardens, and water features. Parents can relax a bit, while children have plenty of room to run around safely.",
"poi_tips": [
{
"tip": "Swan Boats can get very popular, so you may have to wait a while. Try to plan your ride during \"off peak\" times of the day."
},
{
"tip": "Swan Boats only run from April to September."
},
{
"tip": "Kid fans of the story \"Make Way for Ducklings\", can see the bronze statues of the Mallard family near the gate at Beacon and Charles Streets."
},
{
"tip": "Right across Beacon Street you'll find the Bull and Finch Pub. Exterior shots for the TV Show \"Cheers\" were filmed here."
}
],
"traveler_type": [
{
"name": "peace_and_quiet_seeker",
"localized_name": "Peace and Quiet Seeker"
},
{
"name": "must_see",
"localized_name": "Must See"
},
{
"name": "thrifty_traveler",
"localized_name": "Thrifty Traveler"
},
{
"name": "like_a_local",
"localized_name": "Like a Local"
},
{
"name": "nature_lover",
"localized_name": "Nature Lover"
}
],
"visit_length": "1-2 hours",
"location": {
"poi_description": "This Frederick Law Olmsted-designed park, famous for its Swan Boats, has over 600 varieties of trees and an ever-changing array of flowers. It is America's first public garden.",
"see_all_photos": "https://www.tripadvisor.com/Attraction_Review-g60745-d103648-Reviews-Boston_Public_Garden-Boston_Massachusetts.html#photos",
"web_url": "https://www.tripadvisor.com/Attraction_Review-g60745-d103648-Reviews-Boston_Public_Garden-Boston_Massachusetts.html",
"rating": "4.5",
"location_string": "Boston",
"ancestors": [
{
"abbrv": "World",
"level": "World",
"name": "World",
"location_id": "1"
},
{
"abbrv": "North America",
"level": "Continent",
"name": "North America",
"location_id": "19"
},
{
"abbrv": "United States",
"level": "Country",
"name": "United States",
"location_id": "191"
},
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": "Boston",
"level": "City",
"name": "Boston",
"location_id": "60745"
}
],
"location_web_url": "https://www.tripadvisor.com/Tourism-g60745-Boston_Massachusetts-Vacations.html",
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/103648/reviews?key=InternalFull"
}
}
}
]
}
}
}
| Field | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| guide_type | string | Describes whether the travel guide uses a 1-day, 3-day or general itinerary. | ||||||||||
| 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. | ||||||||||
| guide_audience | string | The intended target audience of the travel guide. Valid values are: Everyone, Solo, Friends, Couples, Senior, Family. | ||||||||||
| traveler_type | array | The type of traveler that the travel guide creator believes their guide is suited for. Can be one or more of the following values: History Buff, Thrill Seeker, Shopping Fanatic, Art and Architecture Lover, Nightlife Seeker, Nature Lover, Foodie, Peace and Quiet seeker, LGBT, Beach Goer, Luxury Traveler, Thrifty Traveler, Trendsetter, Like a Local. | ||||||||||
| guide_description | string | A description of the travel guide, as written by the author. | ||||||||||
| guide_tips | array | The guide author’s tips about the city in general. There can be several tips per guide. | ||||||||||
| guide_url | URL | The URL of the Travel Guide (i.e. http://www.tripadvisor.com/Guide-g60745-k167-Boston_Massachusetts.html). | ||||||||||
| 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. | ||||||||||
| guide_poi | array | A list of all POIs for the selected travel guide and their associated details. | ||||||||||
| poi_name | string | The name of the POI. | ||||||||||
| day | string | The day in the itinerary for which the specified POI is recommended. Only applicable to when guide_type = 3_day. | ||||||||||
| poi_photos | array |
Information about the POI’s images. There are 3 images available, each with 1 or more sizes. Each size map has the URL of a photo and its width and height. The size map key names are “thumbnail”, “small”, “medium”, “large” and "original" |
||||||||||
| poi_recommendation | string |
A brief description about why a given POI is important, from the perspective of the guide author. |
||||||||||
| poi_tips | array |
The guide author’s tips about the POI. There can be several per POI. |
||||||||||
| traveler_type | array |
The type of traveler that the travel guide creator believes a given POI is suited for. Can be one or more of the following values: History Buff, Thrill Seeker, Shopping Fanatic, Art and Architecture Lover, Nightlife Seeker, Nature Lover, Foodie, Peace and Quiet seeker, LGBT, Beach Goer, Luxury Traveler, Thrifty Traveler, Trendsetter, Like a Local. |
||||||||||
| visit_length | string |
The recommended duration of visit for the POI. Can be one of the following values: less than 1 hour, 1-2 hours, 2-3 hours, more than 3 hours. |
||||||||||
| location | object |
Information about the POI, that is not specific to the travel guide. |
||||||||||
| poi_description | string |
A description of the POI. |
||||||||||
| see_all_photos | URL |
Link to open all traveler photos posted for this POI in a photo viewer on TripAdvisor. Link will be localized to the correct domain if language other than English is requested. |
||||||||||
| web_url | URL |
Link to the POI detail page on TripAdvisor. Link will be localized to the correct domain if a language other than English is requested. |
||||||||||
| rating | number |
Overall rating for this POI. Not applicable to geographic locations. Rating levels are defined as follows:
|
||||||||||
| location_string | string |
Destination location for the POI. Most commonly written as city, state or city, province/region. In cases where state/province/region is not relevant, then it would be city, country. This string is localized if a language other than English is requested. |
||||||||||
| ancestors | object |
Ancestors describe where the POI or destination lives within the TripAdvisor destination or geo hierarchy. From this, you can derive the city where a POI is located, as well as state/province/region and country. |
||||||||||
| location_web_url | URL |
Link to the destination (/Tourism) page on TripAdvisor. Link will be localized to the correct domain if a language other than English is requested. |
||||||||||
| api_detail_url | URL |
Link to the API url that shows reviews for a given POI. |