# Earlyo — LLM-readable site guide
# This file helps AI crawlers (Google AI Mode, ChatGPT, Perplexity, Claude)
# understand how to consume Earlyo's structured data.

## About Earlyo
Earlyo is a community-driven pre-order discovery platform. We track newly announced pre-orders across gaming, tech, fashion, collectibles, books & media, automotive, home & living, toys & games, sports & outdoors, food & beverage, music & instruments, film & photography, art & design, health & wellness, and pets.

## Structured Data API
- [Today's Pre-orders (JSON)](https://earlyo.com/api/v1/llm/daily): Structured JSON with all published listings for today — includes product names, brands, categories, prices, retailers, pre-order deadlines, ship dates, community signals (upvotes, comments), and images. Updated every 15 minutes. Cached at edge for 5 minutes.
- [Single Listing (JSON)](https://earlyo.com/api/v1/llm/listing/{id}): Detailed JSON for one listing by numeric ID. Each listing in the daily feed includes an `id` field; substitute it into the URL to fetch full details (top comments, editor verdict, all retailers). Example: `https://earlyo.com/api/v1/llm/listing/123`.

## Content Feeds
- [RSS Feed](https://earlyo.com/api/rss): RSS 2.0 feed of recent pre-orders with full HTML content. Last 7 days, up to 50 items.

## Discovery
- [Sitemap](https://earlyo.com/sitemap.xml): Full XML sitemap with all published listings, brands, retailers, categories, and wire editions.
- [Robots.txt](https://earlyo.com/robots.txt): Crawler directives.

## Key Pages
- [Home / Daily Feed](https://earlyo.com): Today's pre-orders, ranked by community votes and discussion activity.
- [Weekly Recap](https://earlyo.com/week): Rolling 7-day pre-order discovery summary.
- [Ending Soon](https://earlyo.com/ending-soon): Pre-orders closing within 48 hours.
- [Search](https://earlyo.com/search): Full-text search across all published listings.
- [Categories](https://earlyo.com/categories): Browse pre-orders by product category.
- [The Wire (Editorial)](https://earlyo.com/wire): Weekly curated editorial recaps with hand-picked featured listings.

## Structure
- Individual listing detail pages are at `/listing/{id}` and include JSON-LD Product + Offer + AggregateRating schema, plus BreadcrumbList schema.
- Brand pages are at `/brand/{name}`.
- Retailer pages are at `/retailer/{name}`.
- Category-filtered search is at `/search?category={slug}`.