{"openapi":"3.0.3","info":{"title":"StungEvents API","version":"1.0.0","description":"Free global events API — search concerts, festivals, sports, comedy and more across 60+ countries; demand artists; plan a night out. Public reads need no auth (100 req/hour/IP); a free API key raises that to 500/day (free forever). Paid tiers up to 250,000/day.","contact":{"email":"api@stungevents.com"},"license":{"name":"Free for use with attribution"}},"servers":[{"url":"https://api.stungevents.com"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Event":{"type":"object","properties":{"title":{"type":"string"},"slug":{"type":"string"},"start_utc":{"type":"string"},"category":{"type":"string"},"venue_name":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"ticket_url":{"type":"string"},"ticket_price_min":{"type":"number"}}}}},"paths":{"/events":{"get":{"summary":"List upcoming events","parameters":[{"name":"city","in":"query","description":"City name","schema":{"type":"string"}},{"name":"country","in":"query","description":"ISO-2 country code","schema":{"type":"string"}},{"name":"category","in":"query","description":"concerts|festivals|sports|comedy|other","schema":{"type":"string"}},{"name":"from","in":"query","description":"ISO start","schema":{"type":"string"}},{"name":"to","in":"query","description":"ISO end","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer"}},{"name":"featured","in":"query","description":"1 for featured only","schema":{"type":"string"}}],"responses":{"200":{"description":"Event list","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"count":{"type":"integer"},"events":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"slug":{"type":"string"},"start_utc":{"type":"string"},"category":{"type":"string"},"venue_name":{"type":"string"},"city":{"type":"string"},"country":{"type":"string"},"ticket_url":{"type":"string"},"ticket_price_min":{"type":"number"}}}}}}}}}}}},"/events/{slug}":{"get":{"summary":"Single event by slug or id","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Event"},"404":{"description":"Not found"}}}},"/search":{"get":{"summary":"Full-text event search","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Results"}}}},"/venues/{slug}":{"get":{"summary":"Venue + its upcoming events","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Venue"}}}},"/city/{slug}":{"get":{"summary":"Events in a city","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"City events"}}}},"/artists/{slug}":{"get":{"summary":"Artist profile","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artist"}}}},"/articles":{"get":{"summary":"News articles","parameters":[{"name":"lang","in":"query","description":"language (default en)","schema":{"type":"string"}},{"name":"category","in":"query","description":"category","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":50}}],"responses":{"200":{"description":"Articles"}}}},"/articles/{slug}":{"get":{"summary":"Full article","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Article"}}}},"/demand-it":{"post":{"summary":"Register Demand It! for an artist in a city","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["artist_name","city"],"properties":{"artist_name":{"type":"string"},"city":{"type":"string"},"country_code":{"type":"string"},"user_email":{"type":"string"}}}}}},"responses":{"200":{"description":"Demand recorded"}}}},"/demand-leaders":{"get":{"summary":"Demand leaderboard (top artists/cities/fastest-growing)","responses":{"200":{"description":"Leaderboard"}}}},"/plan":{"get":{"summary":"Plan My Night for an event","parameters":[{"name":"event_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"narrative","in":"query","description":"1 for an AI summary","schema":{"type":"string"}}],"responses":{"200":{"description":"Plan"}}}},"/register-api-key":{"post":{"summary":"Register a free API key (500 req/day, free forever)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string"},"name":{"type":"string"},"use_case":{"type":"string"}}}}}},"responses":{"200":{"description":"API key (also emailed)"}}}}}}