{"openapi":"3.1.0","info":{"title":"FindEvents public event API","version":"1.0.0","description":"Read-only selected European city events. Null price is unknown. Starting prices do not guarantee availability."},"servers":[{"url":"https://findevents.org"}],"paths":{"/api/events":{"get":{"operationId":"searchEvents","summary":"Search upcoming European events using supported multilingual intent, strict dates/prices and explained relevance. Unknown prices never qualify as paid/free or within budget.","parameters":[{"name":"country","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"venue","in":"query","schema":{"type":"string"}},{"name":"venueId","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string"}},{"name":"to","in":"query","schema":{"type":"string"}},{"name":"maxPrice","in":"query","schema":{"type":"number"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"price","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"quality","in":"query","schema":{"type":"string"}},{"name":"interests","in":"query","schema":{"type":"string"}},{"name":"free","in":"query","schema":{"type":"boolean"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Paginated source-backed events, query interpretation and match reasons. price=all|free|paid; sort=relevance|date|price|votes; votes is anonymous visitor interest, not event quality. quality=verified means data completeness, not event quality; interests are comma-separated category slugs (max 5)."}}}},"/api/events/{id}":{"get":{"operationId":"getEvent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Event record"},"404":{"description":"Not found"}}}},"/api/venues":{"get":{"operationId":"getVenues","responses":{"200":{"description":"Upcoming event venues, stable IDs, addresses, source-observed coordinates and canonical URLs."}}}},"/api/locations":{"get":{"operationId":"getLocations","responses":{"200":{"description":"Supported countries and source-backed cities, event counts and approximate city centres for nearby suggestions."}}}},"/api/guides":{"get":{"operationId":"getGuides","responses":{"200":{"description":"Evidence-linked weekly and weekend guides"}}}},"/api/status":{"get":{"operationId":"getCatalogStatus","responses":{"200":{"description":"Catalog counts and freshness"}}}},"/api/categories":{"get":{"operationId":"getCategories","responses":{"200":{"description":"Available interest categories"}}}}}}