# BR Guide — Data Schema

Best Restaurants Guide is a curated, expert-reviewed restaurant database.
Counts below are live.

## Entities

### City (destination)
- name, slug (`/destinations/{citySlug}`), country
- editorial blurb, lat/lng, featured image
- 464 cities tracked

### Restaurant
- name, slug (`/restaurants/{restaurantSlug}`), city + country
- cuisine tags (array), price range, address, phone, website, email,
  instagram, opening hours
- editorial blurb (expert-reviewed summary)
- awardings: distinction (e.g. "Two MICHELIN Stars") + award system
- lat/lng, featured image
- 13526 restaurants tracked

### Award (system)
- name, slug (`/awards/{awardSlug}`), visible flag
- distinctions (ordered) and groups
- 31 visible award systems (Michelin, La Liste, James Beard, ...)

## Public access surfaces

- Sitemaps: /sitemap.xml (index: pages, destinations, restaurants, awards)
- LLM context: /llms.txt
- Markdown variants: /destinations/{citySlug}/index.md
- HTML pages: /destinations/{citySlug}, /restaurants/{restaurantSlug},
  /awards/{awardSlug}, /awards/{awardSlug}/{distinctionOrGroupSlug}
- Structured data: JSON-LD on every page (Restaurant, ItemList,
  CollectionPage, BreadcrumbList, Organization)

## Programmatic access

There is no public REST read API. Structured reads are available via the
surfaces above (sitemaps + HTML + JSON-LD + markdown). Partnership/API
inquiries: via /contact.
