Call the API with the unique ID for a destination. The response will provide a list of the immediate children in the hierarchy of geographical locations.
| Name | Description |
|---|---|
| lang | The desired language locale. |
| currency | currency code to use for request and response (should follow ISO 4217). |
| category | When the location is a country, specify category=city to specifically list all cities in the country. When category=city, sort order matches the site for this country/region. |
| limit | Number of items returned. |
| offset | Distance from the starting point of the list. |
{
"data": [
{
"see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d60745-m11068-Boston-Massachusetts.html",
"abbrv": null,
"web_url": "http://www.tripadvisor.com/Tourism-g60745-m11068-Boston_Massachusetts-Vacations.html",
"photo": {
"published_date": "2009-11-17T08:56:07-0500",
"id": "22588325",
"is_blessed": true,
"images": {
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/01/58/ab/a5/the-view.jpg"
},
"original": {
"height": "3000",
"width": "4000",
"url": "http://media-cdn.tripadvisor.com/media/photo-o/01/58/ab/a5/the-view.jpg"
},
"small": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/01/58/ab/a5/the-view.jpg"
},
"large": {
"height": "412",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/01/58/ab/a5/the-view.jpg"
},
"medium": {
"height": "187",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/01/58/ab/a5/the-view.jpg"
}
},
"caption": "The view",
"user": null
},
"location_string": "Boston, Massachusetts",
"location_id": "60745",
"address_obj": {
"street1": null,
"street2": null,
"city": null,
"state": "Massachusetts",
"country": "United States",
"postalcode": null,
"address_string": "Boston, MA"
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/60745?key=PARTNER_KEY",
"partner_location_id": [
"c60745"
],
"category": {
"name": "geographic",
"localized_name": "Geographic"
},
"awards": [
{
"award_type": "Traveler's Choice",
"year": "2014",
"images": {
"small": "http://www.tripadvisor.com/img/cdsi/img2/awards/tchotel_2014_L_TM-11068-5.png",
"large": "http://www.tripadvisor.com/img2/awards/TC_2014_downloadable_L_R.jpg"
},
"categories": [
"Destinations"
],
"display_name": "Traveler's Choice"
}
],
"description": "No, you can’t actually park your car in Harvard Yard. What you can do in Boston is enjoy some of the country’s most important historical sites and impassioned sports fans. Catch a game at Fenway Park before heading to the North End for some of the Italian neighborhood’s legendary cannoli. Take in the gilded glory of the State House from the edge of the Boston Common, also the starting point for the Freedom Trail, a walking route between 16 sites that were integral to the American Revolution. ",
"subcategory": [
{
"name": "city",
"localized_name": "City"
}
],
"geo_type": "narrow",
"name": "Boston",
"ancestors": [
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-71.05834",
"latitude": "42.357277"
},
{
"see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d185492-m11068-Cape_Cod-Massachusetts.html",
"abbrv": null,
"web_url": "http://www.tripadvisor.com/Tourism-g185492-m11068-Cape_Cod_Massachusetts-Vacations.html",
"photo": {
"published_date": "2007-10-12T22:31:01-0400",
"id": "17216983",
"is_blessed": true,
"images": {
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/01/06/b5/d7/skaket-beach-sunset.jpg"
},
"original": {
"height": "488",
"width": "777",
"url": "http://media-cdn.tripadvisor.com/media/photo-o/01/06/b5/d7/skaket-beach-sunset.jpg"
},
"small": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/01/06/b5/d7/skaket-beach-sunset.jpg"
},
"large": {
"height": "345",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/01/06/b5/d7/skaket-beach-sunset.jpg"
},
"medium": {
"height": "157",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/01/06/b5/d7/skaket-beach-sunset.jpg"
}
},
"caption": "Skaket Beach Sunset",
"user": null
},
"location_string": "Cape Cod, Massachusetts",
"location_id": "185492",
"address_obj": {
"street1": null,
"street2": null,
"city": null,
"state": "Massachusetts",
"country": "United States",
"postalcode": null,
"address_string": "MA"
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/185492?key=PARTNER_KEY",
"partner_location_id": [],
"category": {
"name": "geographic",
"localized_name": "Geographic"
},
"awards": [],
"description": "The Atlantic crashes on a coastline strewn with quaint harbors, windswept beaches, glorious dunes and blinking lighthouses. Explore Cape Cod National Seashore, bike past cranberry bogs on the Rail Trail or saunter around Sandwich, the Cape's oldest town. Many areas are architectural and culinary gems - full of weathered shingles, whaling captains' mansions, chowder shacks and upscale dining delights. Don't miss Woods Hole Oceanquest, famed Martha's Vineyard or charmingly upbeat Provincetown.",
"subcategory": [
{
"name": "region",
"localized_name": "Region"
}
],
"geo_type": "hybrid",
"name": "Cape Cod",
"ancestors": [
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-70.25693",
"latitude": "41.687366"
},
{
"see_all_photos": "http://www.tripadvisor.com/LocationPhotos-g28942-d29527-m11068-Nantucket-Massachusetts.html",
"abbrv": null,
"web_url": "http://www.tripadvisor.com/Tourism-g29527-m11068-Nantucket_Massachusetts-Vacations.html",
"photo": {
"published_date": "2009-09-02T18:21:23-0400",
"id": "21171189",
"is_blessed": true,
"images": {
"thumbnail": {
"height": "50",
"width": "50",
"url": "http://media-cdn.tripadvisor.com/media/photo-t/01/43/0b/f5/downtown-wharf-ack.jpg"
},
"original": {
"height": "343",
"width": "500",
"url": "http://media-cdn.tripadvisor.com/media/photo-o/01/43/0b/f5/downtown-wharf-ack.jpg"
},
"small": {
"height": "150",
"width": "150",
"url": "http://media-cdn.tripadvisor.com/media/photo-l/01/43/0b/f5/downtown-wharf-ack.jpg"
},
"large": {
"height": "377",
"width": "550",
"url": "http://media-cdn.tripadvisor.com/media/photo-s/01/43/0b/f5/downtown-wharf-ack.jpg"
},
"medium": {
"height": "171",
"width": "250",
"url": "http://media-cdn.tripadvisor.com/media/photo-f/01/43/0b/f5/downtown-wharf-ack.jpg"
}
},
"caption": "Downtown/wharf ACK!",
"user": null
},
"location_string": "Nantucket, Massachusetts",
"location_id": "29527",
"address_obj": {
"street1": null,
"street2": null,
"city": null,
"state": "Massachusetts",
"country": "United States",
"postalcode": null,
"address_string": "Nantucket, MA"
},
"api_detail_url": "http://api.tripadvisor.com/api/partner/2.0/location/29527?key=PARTNER_KEY",
"partner_location_id": [],
"category": {
"name": "geographic",
"localized_name": "Geographic"
},
"awards": [
{
"award_type": "Traveler's Choice",
"year": "2014",
"images": {
"small": "http://www.tripadvisor.com/img/cdsi/img2/awards/tchotel_2014_L_TM-11068-5.png",
"large": "http://www.tripadvisor.com/img2/awards/TC_2014_downloadable_L_R.jpg"
},
"categories": [
"Islands"
],
"display_name": "Traveler's Choice"
}
],
"description": "Windswept beaches, sand dunes, blinking lighthouses and a charming pace of life await on this 50-square mile island. The world's former top whaling port is now designated a National Historic District. Leave the car and take the shuttle or bike around. Seaside cottages, old whaling captains' mansions and historic harbors contain quaint inns, boutique stores, chowder shacks and upscale dining delights. Swim, surf or load up the tackle for Nantucket's excellent striper, bluefish and bonito fishing.",
"subcategory": [
{
"name": "island",
"localized_name": "Island"
}
],
"geo_type": "hybrid",
"name": "Nantucket",
"ancestors": [
{
"abbrv": "MA",
"level": "State",
"name": "Massachusetts",
"location_id": "28942"
},
{
"abbrv": null,
"level": "Country",
"name": "United States",
"location_id": "191"
}
],
"longitude": "-70.099075",
"latitude": "41.28422"
}
],
"paging": {
"previous": null,
"skipped": "0",
"results": "3",
"next": "http://api.tripadvisor.com/api/partner/2.0/location/28942/geos?limit=3&offset=3&key=PARTNER_KEY",
"total_results": "334"
}
}
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| location_id | number | Unique Tripadvisor location ID of the destination or POI. | ||||||||||
| name | string | Name of the POI as listed on Tripadvisor. | ||||||||||
| rating | number |
Overall rating for this POI. Not applicable to geographic locations. Rating levels are defined as follows:
|
||||||||||
| rating_image_url | URL | URL to the bubble rating image for this location. As noted in the Display Guidelines, overall Bubble Ratings must be displayed using the Tripadvisor bubble rating image with the owl icon. | ||||||||||
| num_reviews | number | Count of total reviews published for this location. | ||||||||||
| percent_recommended | number |
Deprecated - will be displayed as null. The percent of reviewers who recommend this location (rated 4/5 or higher). May not be present if there are are not enough reviews to calculate a percentage. |
||||||||||
| description | string | Plaintext description of this location. | ||||||||||
| 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. | ||||||||||
| reviews | object | List of a few recent review snippets of this location. Not available for location type: geographic. | ||||||||||
| category | object | Type of location this is: geographic, hotel, restaurant, attraction. For now, both key and name are the same. | ||||||||||
| subcategory | object | Detailed type of this location. | ||||||||||
| trip_types | object | Object with counts of review for this location for each trip type (business, couples, family, friends, solo). | ||||||||||
| awards | object | Returns a list of all of the awards for this location, which includes Certificate of Excellence, Travelers' Choice, and Green Leader. For each award, a small and large image will be returned as well. | ||||||||||
| latitude | number | The latitude of this location in degrees. Null if unavailable. | ||||||||||
| longitude | number | The longitude of this location in degrees. Null if unavailable. | ||||||||||
| geo_type | string | The tourism classification for geographic locations. Can be 'broad', 'hybrid', or 'narrow'. | ||||||||||
| price_level | string | Range of prices per night for a hotel OR range of prices per meal for a restaurant. Returned in the currency specified as an option. Price ranges include all taxes and fees whenever possible. This field is only applicable for location type: restaurant, hotel. | ||||||||||
| category_counts | number | The number of attractions inside of a geographic location. This field is only applicable for location type: geographic. It is not available at the state/province/country level. | ||||||||||
| web_url | URL | URL to this location on the Tripadvisor site. | ||||||||||
| ancestors | object | List of geographic entities that contain this location. | ||||||||||
| address_obj | object | Object containing address data for this location. | ||||||||||
| wikipedia_info | object | Object containing Wikipedia links for attractions. | ||||||||||
| photo_count | number | Number of Tripadvisor photos for this location. | ||||||||||
| abbrv | string | Abbreviated form of the location name if one exists (MA for Massachusetts, for example). | ||||||||||
| see_all_photos | URL | URL to Tripadvisor photos page for this location. | ||||||||||
| see_all_hotels | URL | URL to Tripadvisor hotels page for this location. | ||||||||||
| see_all_attractions | URL | URL to Tripadvisor attractions page for this location. | ||||||||||
| see_all_restaurants | URL | URL to Tripadvisor restaurants page for this location. | ||||||||||
| api_detail_url | URL | Link to the API url that shows details about one individual location 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. |