Public API · v1

Fan District APIAI & Developer Access

Public, no-auth, read-only access to Experience Lounges, venues, and events. Built for AI assistants, booking agents, and developers. CORS-enabled. Rate limit: 100 requests/min per IP.

CORS: *No API key requiredNo PIIJSON

Endpoints

GET/api/v1/loungesCache: 5 min

List active Experience Lounges. Supports city, eventId, sponsored, limit, offset.

{
  "data": [
    {
      "id": "...",
      "slug": "legends-experience-lounge",
      "title": "Legends Experience Lounge",
      "description": "VIP lounge at Buddy Guy's Legends...",
      "pricePerPersonCents": 0,
      "sponsorFunded": true,
      "perks": ["Reserved table", "Bottle service"],
      "venue": { "name": "Buddy Guy's Legends", "city": "Chicago", "state": "IL" },
      "url": "https://fandistrictos.com/lounges/legends-experience-lounge"
    }
  ],
  "total": 12, "limit": 20, "offset": 0
}

GET/api/v1/lounges/{slug}Cache: 60 sec

Full lounge detail — perks, time slots, availability, sponsor, venue.

{
  "data": {
    "id": "...",
    "title": "...",
    "availability": "in_stock",
    "perks": [...],
    "venue": {...},
    "sponsor": { "name": "...", "logoUrl": "..." }
  }
}

GET/api/v1/venuesCache: 1 hour

List active venues. Supports city, limit.

{
  "data": [
    { "id": "...", "slug": "...", "name": "...", "city": "...", "state": "...", "lat": 41.87, "lng": -87.62 }
  ],
  "total": 28
}

GET/api/v1/eventsCache: 10 min

List active events. Supports city, category, limit.

{
  "data": [
    { "id": "...", "name": "...", "venue": "...", "city": "...", "startDate": "...", "endDate": "..." }
  ],
  "total": 42
}

Discovery

/llms.txt

Plain-text AI crawler intro

/sitemap.xml

Dynamic sitemap of all public pages

/robots.txt

Crawler rules — AI bots explicitly welcomed

Schema.org JSON-LD

Event, FAQPage, BarOrPub on every public page

Want partnership API access?

Fan District data is available for AI assistants, booking agents, and developers building fan-experience tools. For higher rate limits, write access, or sponsor attribution data, get in touch.

hello@fandistrictos.com →