# Giggle Tips - machine-readable experience data

> Giggle Tips publishes structured hotel experience catalogs for AI agents and search engines.
> Data format: Schema.org JSON-LD (Event, Service, Hotel, ItemList).

## Platform index (Tier 0)

Start here for a locale-wide list of all hotel AI catalogs:

- https://giggle.tips/en/ai
- https://giggle.tips/en/ai.json
- https://giggle.tips/en/ai/sitemap.xml

Replace `en` with de, it, fr, es, nl, pt, sk, sl, sv, nb as needed.

## Hotel experience catalogs (Tier 1)

Each hotel with a Giggle app has an AI-readable catalog at:

- https://giggle.tips/en/{hotelCode}/ai
- https://giggle.tips/en/{hotelCode}/ai.json
- https://giggle.tips/en/{hotelCode}/ai/sitemap.xml

Example:

- https://giggle.tips/en/derwaldhof/ai
- https://giggle.tips/en/derwaldhof/ai.json
- https://giggle.tips/en/derwaldhof/ai/sitemap.xml

## Crawl hierarchy

0. Platform hub (`/{locale}/ai`) - index of all hotel AI catalogs
1. Hotel hub (`/{locale}/{hotelCode}/ai`) - streams and all experiences
2. Stream catalog (`/{locale}/{hotelCode}/ai/streams/{stream-slug}`) - categorized subset
3. Experience hub (`/{locale}/experience/{id}/{slug}/ai`) - full entity graph
4. Occurrence leaf (`/{locale}/experience/{id}/{slug}/{occurrence}/ai`) - one bookable date (Events only)

Occurrence keys: `YYYY-MM-DD` (all-day) or `YYYY-MM-DD--HH-MM` (timed same-day sessions).

## Entity rules

- **Event** - scheduled experiences guests attend (workshops, tastings, hikes). One JSON-LD graph per occurrence leaf.
- **Service** - on-demand hotel offerings (spa, rental, room service). Classified from content signals, not only CMS type.
- Optional Event subtypes via `additionalType` (FoodEvent, SportsEvent, ...). Primary `@type` is always Event or Service.
- Hotel = organizer/provider; Giggle Tips = booking platform (`offers.seller`).

## Indexing rules (same as public portal pages)

Only indexable hotels and experiences appear in AI catalogs:

- Hotels on the internal blocklist are excluded entirely.
- Experiences excluded when: guest-information category, no hero/share image, unpublished/hidden, wrong locale, or belonging to a blocked hotel.

## Sitemaps

- Global: https://giggle.tips/sitemap.xml
- Platform AI: https://giggle.tips/en/ai/sitemap.xml
- Per-hotel AI: https://giggle.tips/en/{hotelCode}/ai/sitemap.xml