Skip to main content

​
Brand Hierarchy

The EveryBite platform organizes restaurant data in a hierarchical structure. Understanding this hierarchy helps you work with the right scope of data.

​
The Four Levels

Brand (e.g., Yum! Brands)
└── Chain (e.g., Taco Bell)
    └── Restaurant (e.g., Taco Bell #1234 - Times Square)
        └── Menu (e.g., Breakfast, Lunch, Regional Specials)
The top-level parent company that may own multiple restaurant chains.Examples:
  • Yum! Brands (owns Taco Bell, KFC, Pizza Hut)
  • Inspire Brands (owns Arby’s, Buffalo Wild Wings, Dunkin’)
  • Independent restaurant groups
API Access: A Brand Key gives access to all chains, restaurants, and menus underneath.
A restaurant brand with multiple locations sharing the same concept and (mostly) the same menu.Examples:
  • Taco Bell
  • Honeygrow
  • Chipotle
API Access: A Chain Key gives access to all restaurants in that chain.
A single physical location where diners can order food.Examples:
  • Honeygrow - 1601 Market Street, Philadelphia
  • Taco Bell #1234 - Times Square, NYC
API Access: A Restaurant Key gives access to that location’s menus only.
How menus vary depends on the size of the restaurant operation:
ScaleLocation CountMenu Strategy
Small Chain20-50Single menu across all locations
Regional Chain50-200Regional menu variations
National Chain200+Definitely regional menus
Global ChainInternationalDifferent menus per country/region
A chain with 30 locations might have identical menus everywhere. A national chain with 500+ locations will likely have regional differences—some items available only in certain markets.

​
Querying at Different Levels

Your Menu Key determines what you can query: 
# With a Restaurant Key, query dishes at your location
query {
  dishes(menuKey: "rest_abc123") {
    results {
      dish { name, calories }
    }
  }
}

​
Location-Specific Menus

When a chain has location-specific menus, you can filter dishes by restaurant: 
query {
  dishes(
    menuKey: "chain_xyz789",
    filters: {
      restaurantId: "rest_nyc_001"  # Only dishes at this location
    }
  ) {
    results {
      dish { name }
    }
  }
}

​
Categories Within Menus

Each menu contains categories that organize dishes: 
query {
  categories(menuKey: "your_key") {
    id
    name        # e.g., "Stir-Fry", "Salads", "Drinks"
    dishCount   # Number of dishes in this category
    ordinal     # Display order
  }
}

​
Visual Summary

┌─────────────────────────────────────────────────────────────────┐
│                         BRAND                                    │
│                    (Yum! Brands)                                 │
│                    [Brand Key]                                   │
├───────────────┬─────────────────┬───────────────────────────────┤
│    CHAIN      │     CHAIN       │           CHAIN               │
│  Taco Bell    │      KFC        │        Pizza Hut              │
│ [Chain Key]   │   [Chain Key]   │       [Chain Key]             │
├───────────────┼─────────────────┼───────────────────────────────┤
│  Restaurants  │   Restaurants   │       Restaurants             │
│  ├── NYC #1   │   ├── LA #1     │       ├── Chicago #1          │
│  ├── NYC #2   │   ├── LA #2     │       ├── Chicago #2          │
│  └── etc.     │   └── etc.      │       └── etc.                │
│ [Rest Keys]   │  [Rest Keys]    │      [Rest Keys]              │
├───────────────┴─────────────────┴───────────────────────────────┤
│                         MENUS                                    │
│        Breakfast | Lunch | Dinner | Regional | Seasonal          │
└─────────────────────────────────────────────────────────────────┘

​
Next Steps

Diner Preferences

Learn how to personalize results

Authentication

Understand Menu Keys in depth