Categories, Subcategories, Groups, and Types

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

 

Accommodations/Hotels:

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



Restaurants:

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:

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