# CHI Event Aggregator Integration Context

This file provides context for AI-powered event aggregators integrating with the CHI platform.

## Overview
CHI provides public event feeds in multiple formats so aggregators can display CHI-powered events on their own platforms.

## Feed Endpoints

### JSON Feed
GET /events/feed.json
Returns structured JSON with event data for modern applications and APIs.

Response schema:
{
  "events": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "startDate": "ISO 8601 datetime",
      "endDate": "ISO 8601 datetime",
      "location": {
        "name": "string",
        "address": "string",
        "city": "string",
        "country": "string",
        "lat": "number",
        "lng": "number"
      },
      "organizer": {
        "name": "string",
        "logo": "URL"
      },
      "image": "URL",
      "url": "URL (ticket purchase link)",
      "categories": ["string"],
      "ticketTypes": [
        {
          "name": "string",
          "price": "number",
          "currency": "string",
          "available": "boolean"
        }
      ],
      "status": "draft | published | cancelled | completed"
    }
  ],
  "total": "number",
  "updatedAt": "ISO 8601 datetime"
}

### RSS Feed
GET /events/feed.rss
Standard RSS 2.0 feed compatible with all feed readers and aggregator platforms.

### XML Feed
GET /events/feed.xml
XML format for enterprise and legacy system integrations.

## Integration Guidelines
1. Cache feed responses for at least 5 minutes to reduce load.
2. Use the updatedAt field in JSON responses to detect changes.
3. Always link back to the original event URL for ticket purchases.
4. Respect event status: do not display draft or cancelled events.
5. Include organizer attribution when displaying events.

## Aggregator Partnership
CHI offers a revenue-sharing partnership for aggregators. Earn commissions on every ticket sale that originates from your platform.

Contact us at partners@chi.app to join the aggregator partnership program.

## Related Resources
- Standard LLM Context: /llms.txt
- Full Public Context: /llms-full.txt
- Minimal Context: /llms-minimal.txt
- Developer Overview: https://chi.app/en/developers
- Note: /docs is intentionally blocked from crawlers for now.