==== outdated content ====
Each POI on Tripadvisor is classified under a “category” and “subcategory,” which is included in the API response. Attractions are categorized as "groups" and "categories". Categories and subcategories may also be used to filter the /location method when a destination (geo) location ID is used.
Category is used to define which of the three major POI types the listing belongs to. These are:
Hotel (which includes all accommodation types, excluding vacation rentals)
Restaurant
Attraction
Listings that are accommodations/hotels are each assigned to a single subcategory. This represents how the listing is categorized on the Tripadvisor site. It may be either a Hotel, a Bed and Breakfast, or Specialty Lodging. The subcategory may be applied as a filter to the /location-hotels method.
Categories and subcategories are returned in the API response as follows:
"category": {
"name": "hotel",
"localized_name": "Hotel"
},
"subcategory": [
{
"name": "bb",
"localized_name": "Bed and Breakfast"
}
],
|
Field |
Type |
Description |
|
name |
string |
Name of the POI category or subcategory. |
|
localized_name |
string |
User-facing label of the category or subcategory. This string is localized if a language other than English is requested. |
The Tripadvisor popularity index or ranking is applied to accommodations within their subcategory. Accommodation categories and subcategories are defined as follows:
|
POI Type |
category |
subcategory |
|
Accommodations |
Hotel |
Hotels |
|
Accommodations |
Hotel |
Bed and Breakfast |
|
Accommodations |
Hotel |
Specialty Lodging |
Listings that are restaurants are assigned to a single subcategory.
"category": {
"name": "restaurant",
"localized_name": "Restaurant"
}
"subcategory": [
{
"name": "sit_down",
"localized_name": "Sit down"
}
],
|
Field |
Type |
Description |
|
name |
string |
Name of the POI category or subcategory. |
|
localized_name |
string |
User-facing label of the category or subcategory. This string is localized if a language other than English is requested. |
The Tripadvisor popularity index or ranking is applied to restaurants only within their category. It is not applied at the subcategory level. Restaurant categories and subcategories are defined as follows:
|
POI Type |
Categories |
Subcategories |
|
Restaurants |
Restaurant |
Sit Down |
|
Restaurants |
Restaurant |
Bakery (Note: merged with Cafe) |
|
Restaurants |
Restaurant |
Fast Food (Note: merged with Deli) |
Attractions may belong to one or more groups, and may also be further classified under “categories” which are even more specific. This represents how the listing is categorized on the Tripadvisor site.
Note: “attraction_types” have been deprecated as of February 2017 and are merely additional descriptive labels that further define the business. They may not be used for filtering.
"groups": [
{
"name": "Tours",
"categories": [
{
"name": "City Tours",
"localized_name": "City Tours"
},
{
"name": "Historical & Heritage Tours",
"localized_name": "Historical & Heritage Tours"
},
{
"name": "Private Tours",
"localized_name": "Private Tours"
},
{
"name": "Bike Tours",
"localized_name": "Bike Tours"
},
{
"name": "Night Tours",
"localized_name": "Night Tours"
}
],
"localized_name": "Tours"
},
{
"name": "Outdoor Activities",
"categories": [
{
"name": "Bike Tours",
"localized_name": "Bike Tours"
}
],
"localized_name": "Outdoor Activities"
}
],
|
Field |
Type |
Description |
|
name |
string |
Name of the POI category or subcategory. |
|
groups |
string |
Name of the parent group that categorizes the Attraction. |
|
categories |
string |
List of the child categories associated to the parent group. |
|
localized_name |
string |
User-facing label of the category or subcategory. This string is localized if a language other than English is requested. |
The Tripadvisor popularity ranking is applied to Attraction POIs within their primary group as defined below. An Attraction may have multiple Groups and/or Categories associated to it.
|
POI Type |
Group |
Category |
|
Attractions |
Boat Tours & Water Sports |
Kayaking & canoeing,Stand-Up Paddleboarding,Waterskiing & jetskiing,Swim with dolphins,Surfing, Windsurfing & Kitesurfing,Submarine tours,Shark diving,Scuba & snorkelling,River rafting & tubing,Parasailing & paragliding,Water sports,Speed boats tours,Duck tours,Boat Tours,Boat rentals,Dolphin & whale watching,Fishing charters & tours,Gondola cruises |
|
Attractions |
Casinos & Gambling |
Horse Tracks, Casinos, Dog Tracks |
|
Attractions |
Classes & Workshops |
Classes/Workshops,Cooking classes,Paint & Pottery Studios,Sports Camps/ Clinics |
|
Attractions |
Concerts & Shows |
Jazz Bars,Performances,Dinner Theaters,Concerts,Operas,Symphonies, Ballets,Theaters,Cabaret,Cirque du Soleil,Luaus,Sporting events & packages,Theater & musicals,Blues Bars,Piano Bar,Country Western Bars,Comedy Club |
|
Attractions |
Events |
Food & Drink Festivals,Sporting Events,Cultural Events,Seasonal Fireworks,Exhibitions,Music Festivals |
|
Attractions |
Food & Drink |
Farmers markets,Distillery Tours,Wineries,Breweries,Distilleries,Beer tastings & tours,Coffee & tea tours,Cooking classes,Food tours,Wine tastings & tours,Wine Bar,Other food and wine |
|
Attractions |
Fun & Games |
Bowling Alleys,Movie Theaters,Game/ Entertainment Centers,Comedy Clubs,Character Experiences,Wedding Chapels,Other fun and games,Shooting ranges,Scavenger hunt,Escape games,Rides & Activities,Sports Complexes,Miniature Golf,Paint & Pottery Studios,Dog Tracks,Horse Tracks,Casinos,Playgrounds |
|
Attractions |
Museums |
Observatories/ Planetariums,Military Museums,Museums,Natural History Museums,Children's Museums,Science Museums,Specialty Museums,Art Galleries,Art Museums,History Museums |
|
Attractions |
Nature & Parks |
National Parks,Playgrounds,Biking Trails,Equestrian Trails,Hiking Trails,Motorcycle Trails,Off road/All Terrain Vehicle Trails,Ski/ Snowboard Areas,Beaches,Zoos,Aquariums,Bodies of Water,Canyons,Caverns/ Caves,Dams,Deserts,Forests,Gardens,Geologic Formations,Hot Springs/ Geysers,Islands,Marinas,Mountains,Nature/ Wildlife Areas,Parks,Reefs,State Parks,Valleys,Volcanos,Waterfalls,Other nature and parks |
|
Attractions |
Nightlife |
Wine Bar,Bar, club & pub tours,Gay Bars,Piano Bar,Cigar Bars,Jazz Bars,Karaoke Bars,Country Western Bars,Bar/ Clubs,Blues Bars,Dance Club/ Discos,Comedy Clubs,Coffeehouses |
|
Attractions |
Outdoor Activities |
Sports Camps/ Clinics,Horseback Riding Stables,Golf Courses,Motorcycle Trails,Hiking Trails,Cross-country Ski Areas,Zoos,Surf Camps,Submarine tours,Parasailing & paragliding,Shark diving,Scuba & snorkelling,River rafting & tubing,Boat rentals,Dolphin & whale watching,Gondola cruises,Speed boats tours,Kayaking & canoeing,Equestrian Trails,Off road/All Terrain Vehicle Trails,Biking Trails,Ski/ Snowboard Areas,Trails,Beaches,Scenic Drives,Horse-Drawn Carriage Tours,Jogging Paths/ Tracks,Resort Communities,Other outdoor activities,Zipline tours,Stand-Up Paddleboarding,Ski & snow tours,Safaris, Running tours,Canyoning & Rappelling Tours,Air tours,Nature & wildlife tours,Boat Tours,Hiking & camping tours,Golf tours & tee times,Fishing charters & tours,Eco tours,Climbing tours,Bike tours,Balloon rides,Adrenaline & extreme tours,4WD, ATV & off-road tours,Duck tours,Waterskiing & jetskiing,Swim with dolphins,Surfing, Windsurfing & Kitesurfing,Gear rentals,Water sports |
|
Attractions |
Shopping |
Malls,Shops,Specialty Shops,Art Galleries,Airport Shops,Shopping tours,Fashion shows & tours,Farmers markets,Department Stores,Factory Outlets,Antique Shops,Flea/ Street Markets |
|
Attractions |
Sights & Landmarks |
Ranchs,Neighborhoods,Universities & Schools,Religious Sites,Historic Sites,Ancient Ruins,Educational Sites,Castles,Cemeteries,Churches/ Cathedrals,Scenic/ Historic Walking Areas,Government Buildings,Reservations, Historic Walking Areas,Mines,Civic Centers,Ghost Towns,Military Bases/ Facilities,Battlefields,Missions,Farms,Landmarks/ Points of Interest,Architectural Buildings,Monuments/ Statues,Bridges,Scenic Drives,Observation Decks/ Towers,Lookouts,Lighthouses,Ships,Wharfs/ Piers/ Boardwalks,Fountains, Mysterious Sites,Arenas/ Stadiums/ Fields,Race Car Tracks,Other ranches and farms |
|
Attractions |
Spas & Wellness |
Roman baths,Arab baths,Day Spas,Hammams & Turkish baths,Yoga & pilates,Thermal spas & hot springs,Health Clubs,Spas,Onsen Resorts |
|
Attractions |
Tours |
Gondola cruises,Skydiving,Day Trips,Boat rentals,Dolphin & whale watching,Speed boats tours,Kayaking & canoeing,Parasailing & paragliding, River rafting & tubing,Scuba & snorkelling,Shark diving,Submarine tours,Scenic Railroads,Tours,Factory Tours,Walking tours,Bus tours,Segway Tours,Water sports,Surfing, Windsurfing & Kitesurfing,Swim with dolphins,Waterskiing & jetskiing,Duck tours,Beer tastings & tours,Coffee & tea tours,Food tours,Wine tastings & tours,4WD, ATV & off-road tours,Adrenaline & extreme tours,Balloon rides,Bike tours,Climbing tours,Eco tours,Fishing charters & tours,Golf tours & tee times,Hiking & camping tours,Nature & wildlife tours,Running tours,Air tours,Archaeology tours,City tours,Cultural tours,Ghost & vampire tours,Helicopter tours,Historical & heritage tours,Hop-on Hop-off tours,Literary, art & music tours,Motorcycle tours,Movie & TV tours,Night tours,Ports of Call tours,Private tours,Rail tours,Self-guided tours & rentals,Skip-the-Line tours,Vespa, scooter & moped tours,Bar, club & pub tours,Fashion shows & tours,Shopping tours,Horse-Drawn Carriage Tours,Photography Tours,Stand-Up Paddleboarding,Canyoning & Rappelling Tours,Distillery Tours,Boat Tours,Zipline tours |
|
Attractions |
Transportation |
Ferries/ Boats,Airport services,Bus services,Rail services,Mass Transportation Systems,Transportation,Trams,Airport & ground transfers |
|
Attractions |
Traveler Resources |
Tourist/ Visitor Centers,Libraries,Airport Lounges,Convention Centers |
|
Attractions |
Water & Amusement Parks |
Amusement/ Theme Parks,Disney,Water Parks |
|
Attractions |
Zoos & Aquarium |
Zoos,Aquariums,Other zoos & aquariums |
|
Attractions |
Other |
Other,Neighborhoods |