{"openapi":"3.1.0","info":{"title":"celyn Culture API","version":"1.0.0-draft","description":"Auto-generated from src/lib/public-surface.ts. First iteration: accurate methods/paths/parameters, shallow response envelopes — see this file's header comment (src/lib/openapi.ts) for exactly what is and isn't described yet.","contact":{"email":"julien@celyn.io"}},"servers":[{"url":"https://celyn.io"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/events":{"get":{"summary":"List events with optional geo, date, and category filters","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude for geo search","schema":{"type":"string"}},{"name":"lng","in":"query","required":false,"description":"Longitude for geo search","schema":{"type":"string"}},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (default: 20)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Start date (ISO 8601)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date (ISO 8601)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Oeuvre type: film, play, concert, etc.","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Filter by topic keyword(s)","schema":{"type":"string"}},{"name":"age_min","in":"query","required":false,"description":"Minimum recommended age","schema":{"type":"string"}},{"name":"age_max","in":"query","required":false,"description":"Maximum recommended age","schema":{"type":"string"}},{"name":"grade","in":"query","required":false,"description":"School grade filter — maternelle: PS, MS, GS; primaire: CP, CE1, CE2, CM1, CM2; collège: 6eme→3eme; lycée: seconde, premiere, terminale","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 50, max: 200)","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"image":{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["hosted","derived","unavailable"]},{"type":"null"}]}},"required":["url","sourceUrl","status"],"additionalProperties":false},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"number"},{"type":"null"}]},"occasion":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isSoldOut":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticketsCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"number"},"mentionCount":{"type":"number"},"curriculumTags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"syncUpdatedAt":{"type":"string"},"venue":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","address","city","latitude","longitude","venueType"],"additionalProperties":false},{"type":"null"}]},"oeuvre":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"topics":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ageMin":{"anyOf":[{"type":"number"},{"type":"null"}]},"ageMax":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","title","year","director","imageUrl"],"additionalProperties":false},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"recurrence":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","recurrence"],"additionalProperties":false},{"type":"null"}]},"festivalEditionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"festival":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","imageUrl","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"_links":{"anyOf":[{"type":"object","properties":{"recommendations":{"type":"string"},"similar":{"type":"string"},"opinions":{"type":"string"}},"required":["recommendations","similar","opinions"],"additionalProperties":false},{"type":"object","properties":{},"additionalProperties":false}]}},"required":["id","title","category","description","imageUrl","image","sourceUrl","ticketUrl","startTime","endTime","price","isFree","occasion","buyUrl","isSoldOut","ticketsCheckedAt","isActive","mentionCount","curriculumTags","createdAt","updatedAt","syncUpdatedAt","venue","oeuvre","series","festivalEditionId","festival","_links"],"additionalProperties":false}},"count":{"type":"number"},"syncAt":{"type":"string"},"isDelta":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["data","count","syncAt","isDelta","nextCursor","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/events/series":{"get":{"summary":"List recurring event series (same oeuvre, multiple showings)","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"recurrence":{"anyOf":[{"type":"string"},{"type":"null"}]},"upcomingCount":{"type":"number"}},"required":["id","name","description","recurrence","upcomingCount"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/events/suppressed":{"get":{"summary":"List suppressed events (duplicate/expired/cancelled/invalid) with reason","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"duplicateOf":{"type":"string"},"suppressedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","duplicateOf","suppressedAt","reason"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/events/submissions":{"post":{"summary":"Submit a user-suggested event for review","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"body","in":"query","required":false,"description":"Request body (JSON)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"}},"required":["id","status"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/events/{id}":{"get":{"summary":"Get a single event with venue and oeuvre","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"image":{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["hosted","derived","unavailable"]},{"type":"null"}]}},"required":["url","sourceUrl","status"],"additionalProperties":false},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"number"},{"type":"null"}]},"occasion":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isSoldOut":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticketsCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"syncUpdatedAt":{"type":"string"},"mentionCount":{"type":"number"},"venue":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","address","city","latitude","longitude","venueType"],"additionalProperties":false},{"type":"null"}]},"oeuvre":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","year","director","imageUrl"],"additionalProperties":false},{"type":"null"}]},"series":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"recurrence":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","recurrence"],"additionalProperties":false},{"type":"null"}]},"festivalEditionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"festival":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","imageUrl","startsAt","endsAt"],"additionalProperties":false},{"type":"null"}]},"_links":{"anyOf":[{"type":"object","properties":{"recommendations":{"type":"string"},"similar":{"type":"string"},"opinions":{"type":"string"}},"required":["recommendations","similar","opinions"],"additionalProperties":false},{"type":"object","properties":{},"additionalProperties":false}]}},"required":["id","title","category","description","imageUrl","image","sourceUrl","ticketUrl","startTime","endTime","price","isFree","occasion","buyUrl","isSoldOut","ticketsCheckedAt","isActive","createdAt","updatedAt","syncUpdatedAt","mentionCount","venue","oeuvre","series","festivalEditionId","festival","_links"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues":{"get":{"summary":"List venues with optional geo or city filter","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude for geo search","schema":{"type":"string"}},{"name":"lng","in":"query","required":false,"description":"Longitude for geo search","schema":{"type":"string"}},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (default: 20)","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"Filter by city name","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 50, max: 200)","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"establishment → adds `establishment` {kind, accessibility, erp, capacity, sources[]} (beta, key scope 'establishment' on request, else 403). Weak ETag + Cache-Control: private, max-age=3600. Credit each sources[] entry (licence + observedAt) when redistributing.","schema":{"type":"string"},"x-required-scope":"establishment","x-stability":"beta","x-self-serve":false},{"name":"accessible","in":"query","required":false,"description":"true → only venues whose entrance is accessible per Acceslibre (fact confidence >= 0.70). Scope 'establishment'.","schema":{"type":"string"},"x-required-scope":"establishment","x-stability":"beta","x-self-serve":false},{"name":"erp_type","in":"query","required":false,"description":"Comma-separated ERP type letters (e.g. L,Y). Partial fact (Paris: Préfecture de Police Ad'AP list). Scope 'establishment'.","schema":{"type":"string"},"x-required-scope":"establishment","x-stability":"beta","x-self-serve":false},{"name":"capacity_min","in":"query","required":false,"description":"Minimum hall gauge (seats). Scope 'establishment'.","schema":{"type":"string"},"x-required-scope":"establishment","x-stability":"beta","x-self-serve":false}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueCategories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAttribution":{"anyOf":[{"type":"string"},{"type":"null"}]},"geofenceRadius":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentionCount":{"type":"number"},"establishment":{"anyOf":[{"type":"object","properties":{"kind":{"anyOf":[{"type":"string","enum":["establishment","non_establishment","unknown"]},{"type":"null"}]},"accessibility":{"anyOf":[{"type":"object","properties":{"entrance":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"path":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"restroom":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"staff":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]}},"required":["entrance","path","restroom","staff"],"additionalProperties":false},{"type":"null"}]},"erp":{"anyOf":[{"type":"object","properties":{"type":{"anyOf":[{"type":"string","enum":["J","L","M","N","O","P","R","S","T","U","V","W","X","Y","PA","CTS","SG","PS","GA","OA","EF","REF"]},{"type":"null"}]},"category":{"anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","category","validUntil"],"additionalProperties":false},{"type":"null"}]},"capacity":{"anyOf":[{"type":"object","properties":{"hall":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"screens":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["hall","screens"],"additionalProperties":false},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"name":{"type":"string"},"license":{"type":"string"},"observedAt":{"type":"string"},"lastSeenAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source","name","license","observedAt","lastSeenAt","url"],"additionalProperties":false}}},"required":["kind","accessibility","erp","capacity","sources"],"additionalProperties":false},{"type":"null"}]}},"required":["id","supabaseId","name","address","city","latitude","longitude","venueType","venueCategories","website","metadata","imageUrl","imageAttribution","geofenceRadius","mentionCount"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues/{id}":{"get":{"summary":"Get a venue with its event count","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"include","in":"query","required":false,"description":"establishment → adds `establishment` {kind, accessibility, erp, capacity, sources[]} (beta, key scope 'establishment' on request, else 403). Weak ETag + Cache-Control: private, max-age=3600. Credit each sources[] entry (licence + observedAt) when redistributing.","schema":{"type":"string"},"x-required-scope":"establishment","x-stability":"beta","x-self-serve":false}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueCategories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAttribution":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"number"},"geofenceRadius":{"anyOf":[{"type":"number"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"eventCount":{"type":"number"},"mentionCount":{"type":"number"},"establishment":{"anyOf":[{"type":"object","properties":{"kind":{"anyOf":[{"type":"string","enum":["establishment","non_establishment","unknown"]},{"type":"null"}]},"accessibility":{"anyOf":[{"type":"object","properties":{"entrance":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"path":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"restroom":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]},"staff":{"anyOf":[{"type":"object","properties":{"present":{"type":"boolean"}},"required":["present"],"additionalProperties":false},{"type":"null"}]}},"required":["entrance","path","restroom","staff"],"additionalProperties":false},{"type":"null"}]},"erp":{"anyOf":[{"type":"object","properties":{"type":{"anyOf":[{"type":"string","enum":["J","L","M","N","O","P","R","S","T","U","V","W","X","Y","PA","CTS","SG","PS","GA","OA","EF","REF"]},{"type":"null"}]},"category":{"anyOf":[{"type":"integer","minimum":1,"maximum":5},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","category","validUntil"],"additionalProperties":false},{"type":"null"}]},"capacity":{"anyOf":[{"type":"object","properties":{"hall":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"screens":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["hall","screens"],"additionalProperties":false},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"name":{"type":"string"},"license":{"type":"string"},"observedAt":{"type":"string"},"lastSeenAt":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source","name","license","observedAt","lastSeenAt","url"],"additionalProperties":false}}},"required":["kind","accessibility","erp","capacity","sources"],"additionalProperties":false},{"type":"null"}]}},"required":["id","supabaseId","name","address","city","latitude","longitude","venueType","venueCategories","website","metadata","imageUrl","imageAttribution","source","sourceId","isActive","geofenceRadius","createdAt","updatedAt","eventCount","mentionCount"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues/{id}/seances":{"get":{"summary":"List upcoming seances at a venue","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startsAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"oeuvre":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","year","director","imageUrl"],"additionalProperties":false}},"required":["id","startsAt","endsAt","room","price","oeuvre"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues/{id}/mentions":{"get":{"summary":"Critic/social opinions mentioning a venue (restaurant/bar reviews)","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"opinionSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"keyQuotes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}]},"mentionSource":{"type":"string"},"episodeTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"episodePublishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"episodeAudioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","opinionSummary","keyQuotes","criticName","sentiment","mentionSource","episodeTitle","episodePublishedAt","episodeAudioUrl","sourceUrl","showName"],"additionalProperties":false,"description":"Press mention of a venue. Editorial coverage item (what the source talked about), not an opinion object: opinionSummary and sentiment may be null."}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues/trending":{"get":{"summary":"\"À la mode\" venues ranked by recency × authority × sentiment","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAttribution":{"anyOf":[{"type":"string"},{"type":"null"}]},"mentionCount":{"type":"number"},"trendingScore":{"type":"number"}},"required":["id","name","city","venueType","metadata","imageUrl","imageAttribution","mentionCount","trendingScore"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/venues/submissions":{"post":{"summary":"Submit a user-suggested venue for review","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"body","in":"query","required":false,"description":"Request body (JSON)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"}},"required":["id","status"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/seances":{"get":{"summary":"List screenings/showtimes","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"venue_id","in":"query","required":false,"description":"Filter by venue UUID","schema":{"type":"string"}},{"name":"oeuvre_id","in":"query","required":false,"description":"Filter by oeuvre UUID","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude for geo search","schema":{"type":"string"}},{"name":"lng","in":"query","required":false,"description":"Longitude for geo search","schema":{"type":"string"}},{"name":"radius_km","in":"query","required":false,"description":"Search radius (default: 20)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Start date (ISO 8601)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date (ISO 8601)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 50, max: 200)","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"startsAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"syncUpdatedAt":{"type":"string"},"oeuvre":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","year","director","imageUrl"],"additionalProperties":false},"venue":{"type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","address","city","latitude","longitude","venueType"],"additionalProperties":false}},"required":["id","startsAt","endsAt","room","price","source","createdAt","updatedAt","syncUpdatedAt","oeuvre","venue"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/seances/{id}":{"get":{"summary":"Get a single seance by ID","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"startsAt":{"type":"string"},"endsAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"room":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"syncUpdatedAt":{"type":"string"},"oeuvre":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","year","director","imageUrl"],"additionalProperties":false},"venue":{"type":"object","properties":{"id":{"type":"string"},"supabaseId":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","address","city","latitude","longitude","venueType"],"additionalProperties":false}},"required":["id","startsAt","endsAt","room","price","source","createdAt","updatedAt","syncUpdatedAt","oeuvre","venue"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/oeuvres":{"get":{"summary":"List curated oeuvres with type/topic filters","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"oeuvre_type","in":"query","required":false,"description":"Filter by type: film, play, concert, etc.","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Filter by topic keyword(s)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"\"mentioned\": most recently discussed first; adds sourceCount, lastMentionedAt, releaseDateTheatricalFr/DigitalFr/TvFr, streamingLatestArrivalAt, nowShowing, nextEpisodeAt (TV rows: next episode air date, YYYY-MM-DD or null), and awards/latestAwardAt on oeuvres with a literary prize selection. Every list shape carries editorialRanks [{list, tier: top10|top25|top50|top100}] on oeuvres present in an editorial best-of list (key absent otherwise). \"upcoming\": films releasing in FR cinemas within within_days (default 60), playable trailer (trailerUrl) first, then external trailer page (trailerExternalUrl), then soonest; adds the same release/nowShowing fields","schema":{"type":"string"}},{"name":"within_days","in":"query","required":false,"description":"sort=upcoming window in days (default 60, clamped 1..180)","schema":{"type":"string"}},{"name":"award","in":"query","required":false,"description":"Only oeuvres with a literary prize selection/win for this prize slug (goncourt, renaudot, femina, medicis, ...)","schema":{"type":"string"}},{"name":"awarded","in":"query","required":false,"description":"\"true\": only oeuvres with any literary prize selection/win","schema":{"type":"string"}},{"name":"provider","in":"query","required":false,"description":"FR streaming platform(s): TMDB provider id or slug from /api/oeuvres/providers (netflix, prime-video, crunchyroll, france-tv, ...), comma-separated = any of. Matches offers included with the service (flatrate/free/ads), not rent/buy","schema":{"type":"string"}},{"name":"anime","in":"query","required":false,"description":"\"true\": only anime (Japanese animation); \"false\": exclude anime","schema":{"type":"string"}},{"name":"platform","in":"query","required":false,"description":"Game platform(s) (games only): ps5, ps4, xbox-series, xbox-one, switch, switch-2, pc, mac, ios, android — comma-separated = any of; an unknown slug matches nothing. Game rows carry `platforms`; with sort=upcoming&type=game (games with a Europe/Worldwide release in within_days, soonest first) rows add `upcomingRelease` {date, platforms}","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 50, max: 200)","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"trailerUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"trailerExternalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"topics":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"curriculumTags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ageMin":{"anyOf":[{"type":"number"},{"type":"null"}]},"ageMax":{"anyOf":[{"type":"number"},{"type":"null"}]},"isKidFriendly":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"releaseStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextAirDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAirDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"isAnime":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"streamingProviderIds":{"type":"array","items":{"type":"number"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"sourceCount":{"type":"number"},"lastMentionedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseDateTheatricalFr":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseDateDigitalFr":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseDateTvFr":{"anyOf":[{"type":"string"},{"type":"null"}]},"streamingLatestArrivalAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"nowShowing":{"type":"boolean"},"nextScreeningAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"awards":{"type":"array","items":{"type":"object","properties":{"prize":{"type":"string"},"prizeSlug":{"type":"string"},"year":{"type":"number"},"stage":{"type":"string","enum":["selection_1","selection_2","selection_3","finalist","winner"]},"category":{"type":"string"},"announcedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["prize","prizeSlug","year","stage","category","announcedAt"],"additionalProperties":false}},"latestAwardAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"editorialRanks":{"type":"array","items":{"type":"object","properties":{"list":{"type":"string"},"tier":{"type":"string","enum":["top10","top25","top50","top100"]}},"required":["list","tier"],"additionalProperties":false}},"platforms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"releaseDateGameFr":{"anyOf":[{"type":"string"},{"type":"null"}]},"upcomingRelease":{"anyOf":[{"type":"object","properties":{"date":{"type":"string"},"platforms":{"type":"array","items":{"type":"string"}}},"required":["date","platforms"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","oeuvreType","director","author","publisher","year","imageUrl","trailerUrl","trailerExternalUrl","genres","description","topics","curriculumTags","ageMin","ageMax","releaseStatus","nextAirDate","lastAirDate","isAnime","streamingProviderIds","createdAt","updatedAt"],"additionalProperties":false}},"count":{"type":"number"},"total":{"type":"number"},"syncAt":{"type":"string"},"isDelta":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["data","count","total","syncAt","isDelta","nextCursor","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/episodes/upcoming":{"get":{"summary":"TV episodes airing soon (series + anime), with their series and FR streaming platforms","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[{"name":"from","in":"query","required":false,"description":"First air date, YYYY-MM-DD (default: today, Europe/Paris)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"Last air date, YYYY-MM-DD (default: from + 7 days; window capped at 60 days)","schema":{"type":"string"}},{"name":"provider","in":"query","required":false,"description":"FR streaming platform(s), same ids/slugs as GET /api/oeuvres?provider= (included offers only)","schema":{"type":"string"}},{"name":"anime","in":"query","required":false,"description":"\"true\": only anime; \"false\": exclude anime","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 50, max: 200)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/oeuvres/providers":{"get":{"summary":"FR streaming platforms (Netflix, Prime Video, Crunchyroll, France.tv, ...) with how many oeuvres each includes","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[{"name":"min_count","in":"query","required":false,"description":"Hide platforms with fewer oeuvres (default 1)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"number"},"slug":{"type":"string"},"name":{"type":"string"},"logoPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreCount":{"type":"number"},"tvCount":{"type":"number"},"filmCount":{"type":"number"},"animeCount":{"type":"number"},"memberProviderIds":{"type":"array","items":{"type":"number"}}},"required":["providerId","slug","name","logoPath","logoUrl","oeuvreCount","tvCount","filmCount","animeCount","memberProviderIds"],"additionalProperties":false}},"count":{"type":"number"},"region":{"type":"string","const":"FR"},"attribution":{"type":"string"}},"required":["data","count","region","attribution"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/oeuvres/game-platforms":{"get":{"summary":"Game platforms (PS5, Xbox Series, Switch, Switch 2, PC, ...) with how many games each has and how many release in the next 180 days","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"gameCount":{"type":"number"},"upcomingCount":{"type":"number"}},"required":["slug","name","gameCount","upcomingCount"],"additionalProperties":false}},"count":{"type":"number"},"attribution":{"type":"string"}},"required":["data","count","attribution"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/oeuvres/{id}":{"get":{"summary":"Get an oeuvre enriched with podcast critic opinions (and literary prize awards, editorial list tiers)","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"trailerUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"trailerExternalUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"tmdbId":{"anyOf":[{"type":"number"},{"type":"null"}]},"allocineId":{"anyOf":[{"type":"string"},{"type":"null"}]},"isbn":{"anyOf":[{"type":"string"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"thematicTags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"topics":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"curriculumTags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"ageMin":{"anyOf":[{"type":"number"},{"type":"null"}]},"ageMax":{"anyOf":[{"type":"number"},{"type":"null"}]},"releaseStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextAirDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAirDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"streamingProviders":{"anyOf":[{"type":"object","properties":{"link":{"type":"string"},"providers":{"type":"array","items":{"type":"object","properties":{"providerId":{"type":"number"},"providerName":{"type":"string"},"logoPath":{"type":"string"},"type":{"type":"string","enum":["flatrate","rent","buy"]},"monetization":{"type":"string","enum":["flatrate","free","ads","rent","buy"]}},"required":["providerId","providerName","logoPath","type","monetization"],"additionalProperties":false}}},"required":["link","providers"],"additionalProperties":false},{"type":"null"}]},"isAnime":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"igdbId":{"anyOf":[{"type":"number"},{"type":"null"}]},"developer":{"anyOf":[{"type":"string"},{"type":"null"}]},"platforms":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"releaseDateGameFr":{"anyOf":[{"type":"string"},{"type":"null"}]},"releases":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"platformName":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"precision":{"type":"string","enum":["day","month","quarter","year","tbd"]},"human":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["platform","platformName","region","date","precision","human","status"],"additionalProperties":false}},"releasesFr":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"platformName":{"type":"string"},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"precision":{"type":"string","enum":["day","month","quarter","year","tbd"]},"human":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["platform","platformName","region","date","precision","human","status"],"additionalProperties":false}},"storeLinks":{"type":"array","items":{"type":"object","properties":{"store":{"type":"string","enum":["steam","playstation","xbox","nintendo","epic","gog"]},"url":{"type":"string"}},"required":["store","url"],"additionalProperties":false}},"gameDataAttribution":{"type":"string"},"location":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"wikidataId":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"venue":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","name","city","latitude","longitude"],"additionalProperties":false},{"type":"null"}]}},"required":["label","wikidataId","venueId","venue"],"additionalProperties":false},{"type":"null"}]},"nextScreeningAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"nowShowing":{"type":"boolean"},"nextScreening":{"anyOf":[{"type":"object","properties":{"startsAt":{"type":"string"},"venueId":{"type":"string"},"venueName":{"type":"string"}},"required":["startsAt","venueId","venueName"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"opinionCount":{"type":"number"},"awards":{"type":"array","items":{"type":"object","properties":{"prize":{"type":"string"},"prizeSlug":{"type":"string"},"year":{"type":"number"},"stage":{"type":"string","enum":["selection_1","selection_2","selection_3","finalist","winner"]},"category":{"type":"string"},"announcedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["prize","prizeSlug","year","stage","category","announcedAt"],"additionalProperties":false}},"latestAwardAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"editorialRanks":{"type":"array","items":{"type":"object","properties":{"list":{"type":"string"},"tier":{"type":"string","enum":["top10","top25","top50","top100"]}},"required":["list","tier"],"additionalProperties":false}},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"opinions":{"type":"array","items":{"type":"object","properties":{"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"sentiment":{"type":"string","enum":["very_positive","positive","mixed","negative","very_negative"],"description":"Never null: an opinion without a sentiment is not published."},"keyQuotes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"episodeTitle":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"publishedAt":{"type":"string"},"segmentStart":{"anyOf":[{"type":"number"},{"type":"null"}]},"segmentEnd":{"anyOf":[{"type":"number"},{"type":"null"}]},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"episodeId":{"type":"string"}},"required":["criticName","opinionSummary","sentiment","keyQuotes","episodeTitle","showName","station","publishedAt","segmentStart","segmentEnd","audioUrl","episodeId"],"additionalProperties":false}}},"required":["id","title","originalTitle","oeuvreType","year","director","author","description","genres","imageUrl","trailerUrl","trailerExternalUrl","duration","tmdbId","allocineId","isbn","publisher","thematicTags","topics","curriculumTags","ageMin","ageMax","releaseStatus","nextAirDate","lastAirDate","streamingProviders","isAnime","createdAt","updatedAt","opinionCount","awards","latestAwardAt","_links"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/oeuvres/{id}/similar":{"get":{"summary":"Find similar oeuvres via vector search","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (default: 10, max: 50)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"distance":{"type":"number"}},"required":["id","title","oeuvreType","director","year","imageUrl","genres","distance"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/sources":{"get":{"summary":"List all tracked podcast shows","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"rssUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"number"},"createdAt":{"type":"string"},"inboundMentionCount":{"type":"number"},"coveredTypes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["id","name","showName","station","rssUrl","category","coverUrl","sourceType","language","active","createdAt","inboundMentionCount","coveredTypes"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/episodes":{"get":{"summary":"List episodes with oeuvre mention counts","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"source_id","in":"query","required":false,"description":"Filter by podcast source UUID","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 20, max: 100)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationSeconds":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"type":"string"},"author":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"topics":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"curriculumTags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"mentionCount":{"type":"number"},"podcastMentionCount":{"type":"number"}},"required":["id","title","description","audioUrl","publishedAt","durationSeconds","status","author","showName","station","category","coverUrl","sourceType","topics","curriculumTags","mentionCount","podcastMentionCount"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/about/{oeuvre_id}":{"get":{"summary":"Get podcast segments discussing a specific oeuvre","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"sentiment":{"type":"string","enum":["very_positive","positive","mixed","negative","very_negative"],"description":"Never null: an opinion without a sentiment is not published."},"keyQuotes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"segmentStart":{"anyOf":[{"type":"number"},{"type":"null"}]},"segmentEnd":{"anyOf":[{"type":"number"},{"type":"null"}]},"episodeId":{"type":"string"},"episodeTitle":{"type":"string"},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"type":"string"},"station":{"type":"string"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"youtubeVideoId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["criticName","opinionSummary","sentiment","keyQuotes","segmentStart","segmentEnd","episodeId","episodeTitle","audioUrl","publishedAt","showName","station","coverUrl","sourceType","youtubeVideoId"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/about-source/{source_id}":{"get":{"summary":"Get podcast segments from a specific source discussing any oeuvre","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"opinionSummary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"sentiment":{"type":"string","enum":["very_positive","positive","mixed","negative","very_negative"],"description":"Never null: an opinion without a sentiment is not published."},"keyQuotes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"segmentStart":{"anyOf":[{"type":"number"},{"type":"null"}]},"segmentEnd":{"anyOf":[{"type":"number"},{"type":"null"}]},"episodeId":{"type":"string"},"episodeTitle":{"type":"string"},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"type":"string"},"station":{"type":"string"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"rawTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"rawStation":{"anyOf":[{"type":"string"},{"type":"null"}]},"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["opinionSummary","sentiment","keyQuotes","segmentStart","segmentEnd","episodeId","episodeTitle","audioUrl","publishedAt","showName","station","coverUrl","sourceType","rawTitle","rawStation","criticName"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/feed":{"get":{"summary":"Chronological feed of recent podcast mentions","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (default: 20, max: 50)","schema":{"type":"string"}},{"name":"source_type","in":"query","required":false,"description":"Only items from sources of this type: rss (audio podcasts), youtube (videos), instagram, … Unknown value → 400","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"episodeId":{"type":"string"},"title":{"type":"string"},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"type":"string"},"station":{"type":"string"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"youtubeVideoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvres":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"type":{"type":"string"},"segmentStart":{"anyOf":[{"type":"number"},{"type":"null"}]},"segmentEnd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","title","type","segmentStart","segmentEnd"],"additionalProperties":false}},"startAt":{"anyOf":[{"type":"number"},{"type":"null"}]},"nearestEventKm":{"anyOf":[{"type":"number"},{"type":"null"}]},"soonestEventAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"},"signals":{"type":"object","properties":{"freshness":{"type":"number"},"geo":{"type":"number"},"eventSoon":{"type":"number"},"pulse":{"type":"number"}},"required":["freshness","geo","eventSoon","pulse"],"additionalProperties":false}},"required":["episodeId","title","audioUrl","publishedAt","showName","station","coverUrl","sourceType","youtubeVideoId","oeuvres","startAt","nearestEventKm","soonestEventAt","score","signals"],"additionalProperties":false}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/podcasts/recommendations":{"get":{"summary":"Recommend episodes by semantic similarity to an oeuvre","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"similar_to","in":"query","required":false,"description":"Oeuvre UUID (required)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 10, max: 50)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"episodeId":{"type":"string"},"episodeTitle":{"type":"string"},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"type":"string"},"station":{"type":"string"},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"mentionTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"distance":{"type":"number"}},"required":["episodeId","episodeTitle","audioUrl","publishedAt","showName","station","coverUrl","sourceType","mentionTitle","opinionSummary","distance"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/recommendations/{oeuvreId}":{"get":{"summary":"Multi-dimensional ranked recommendations based on a source oeuvre","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude for geo proximity scoring","schema":{"type":"string"}},{"name":"lng","in":"query","required":false,"description":"Longitude for geo proximity scoring","schema":{"type":"string"}},{"name":"radius_km","in":"query","required":false,"description":"Geo search radius in km (default: 25)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Start date filter (ISO 8601)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"End date filter (ISO 8601)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Oeuvre type: film, play, concert, etc.","schema":{"type":"string"}},{"name":"context","in":"query","required":false,"description":"Usage context (e.g. family outing, date night)","schema":{"type":"string"}},{"name":"grade","in":"query","required":false,"description":"School grade filter — maternelle: PS, MS, GS; primaire: CP, CE1, CE2, CM1, CM2; collège: 6eme→3eme; lycée: seconde, premiere, terminale","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 10, max: 30)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}},"required":["id","title"],"additionalProperties":false}},"reasoning":{}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/recommendations":{"post":{"summary":"AI-powered recommendations using LLM re-ranking with podcast intelligence","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"body","in":"query","required":false,"description":"Request body (JSON)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}},"required":["id","title"],"additionalProperties":false}},"reasoning":{}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/recommendations/batch":{"post":{"summary":"Batch multiple recommendation queries with deduplication","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"body","in":"query","required":false,"description":"Request body (JSON)","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"query_index":{"type":"number"},"recommendations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}},"required":["id","title"],"additionalProperties":false}},"reasoning":{}},"required":["query_index","recommendations"],"additionalProperties":false}},"shared":{"type":"array","items":{"type":"object","properties":{"matched_queries":{"type":"array","items":{"type":"number"}},"recommendation":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"type":"number"}},"required":["id","title"],"additionalProperties":false}},"required":["matched_queries","recommendation"],"additionalProperties":false}}},"required":["results","shared"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curators":{"get":{"summary":"List all podcast sources ranked by curator authority","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"curators":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"credibilityScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"tier":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"isVerified":{"type":"boolean"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"mentionCount":{"type":"number"},"episodeCount":{"type":"number"}},"required":["sourceId","showName","station","credibilityScore","tier","category","isVerified","notes","mentionCount","episodeCount"],"additionalProperties":false}},"count":{"type":"number"}},"required":["curators","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curators/{source_id}":{"get":{"summary":"Get detailed authority info for a specific podcast source","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"sourceId":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"rssUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"credibilityScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"tier":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"isVerified":{"type":"boolean"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"recentMentions":{"type":"array","items":{"type":"object","properties":{"rawTitle":{"type":"string"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}]},"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["rawTitle","sentiment","criticName","opinionSummary","publishedAt"],"additionalProperties":false,"description":"Editorial coverage item (what the source talked about), not an opinion object: opinionSummary and sentiment may be null."}}},"required":["sourceId","showName","station","rssUrl","credibilityScore","tier","category","isVerified","notes","createdAt","updatedAt","recentMentions"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/search/thematic":{"get":{"summary":"Semantic search across oeuvres, events, and podcasts","tags":["culture"],"x-stability":"stable","x-self-serve":true,"parameters":[{"name":"q","in":"query","required":false,"description":"Search query (required)","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Comma-separated: oeuvre, event, podcast","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default: 20)","schema":{"type":"string"}},{"name":"age_min","in":"query","required":false,"description":"Minimum recommended age","schema":{"type":"string"}},{"name":"age_max","in":"query","required":false,"description":"Maximum recommended age","schema":{"type":"string"}},{"name":"grade","in":"query","required":false,"description":"School grade filter — maternelle: PS, MS, GS; primaire: CP, CE1, CE2, CM1, CM2; collège: 6eme→3eme; lycée: seconde, premiere, terminale","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["oeuvre","event","podcast"]},"score":{"type":"number"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","type","score","source"],"additionalProperties":false}},"query":{"type":"string"},"total":{"type":"number"}},"required":["results","query","total"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/critics":{"get":{"summary":"List critics with their podcast authority profile","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"},"outletName":{"anyOf":[{"type":"string"},{"type":"null"}]},"outletUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"photoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"bioShort":{"anyOf":[{"type":"string"},{"type":"null"}]},"tasteSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"signatureQuote":{"anyOf":[{"type":"string"},{"type":"null"}]},"verticals":{"type":"array","items":{"type":"string"}},"isFeatured":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","displayName","outletName","outletUrl","photoUrl","bioShort","tasteSummary","signatureQuote","verticals","isFeatured","createdAt","updatedAt"],"additionalProperties":false}},"hasMore":{"type":"boolean"}},"required":["data","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/festivals":{"get":{"summary":"List upcoming festival editions","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"editions":{"type":"array","items":{"type":"object","properties":{"editionId":{"type":"string"},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteNwLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteNwLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteSeLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteSeLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteCenterLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteCenterLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lineupFetchedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalId":{"type":"string"},"festivalTitle":{"type":"string"},"festivalType":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalImageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["editionId","year","startDate","endDate","city","country","timezone","siteNwLat","siteNwLng","siteSeLat","siteSeLng","siteCenterLat","siteCenterLng","source","sourceUrl","lineupFetchedAt","festivalId","festivalTitle","festivalType","festivalDescription","festivalImageUrl"],"additionalProperties":false}}},"required":["editions"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/festivals/{editionId}/lineup":{"get":{"summary":"Artist grid for a festival edition (stage/day lineup)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"edition":{"type":"object","properties":{"editionId":{"type":"string"},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"siteNwLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteNwLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteSeLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteSeLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteCenterLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"siteCenterLng":{"anyOf":[{"type":"number"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lineupFetchedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalId":{"type":"string"},"festivalTitle":{"type":"string"},"festivalType":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalImageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["editionId","year","startDate","endDate","city","country","timezone","siteNwLat","siteNwLng","siteSeLat","siteSeLng","siteCenterLat","siteCenterLng","source","sourceUrl","lineupFetchedAt","festivalId","festivalTitle","festivalType","festivalDescription","festivalImageUrl"],"additionalProperties":false},"stages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"size":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"mapX":{"anyOf":[{"type":"number"},{"type":"null"}]},"mapY":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","name","size","latitude","longitude","mapX","mapY"],"additionalProperties":false}},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"artistNameRaw":{"type":"string"},"artistOeuvreId":{"anyOf":[{"type":"string"},{"type":"null"}]},"stageId":{"anyOf":[{"type":"string"},{"type":"null"}]},"stageName":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"isHeadliner":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"source":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","artistNameRaw","artistOeuvreId","stageId","stageName","slotDate","slotStart","slotEnd","isHeadliner","source"],"additionalProperties":false}}},"required":["edition","stages","entries"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/festivals/{editionId}/events":{"get":{"summary":"Event programme bridged to a festival edition","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"editionId":{"type":"string"},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"venueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueName":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueLat":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueLng":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","title","category","description","imageUrl","sourceUrl","ticketUrl","startTime","endTime","price","isFree","venueId","venueName","venueCity","venueLat","venueLng"],"additionalProperties":false}}},"required":["editionId","year","events"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/festivals/by-oeuvre/{oeuvreId}":{"get":{"summary":"Which festivals feature a given artist/oeuvre","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"oeuvreId":{"type":"string"},"editions":{"type":"array","items":{"type":"object","properties":{"editionId":{"type":"string"},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"festivalId":{"type":"string"},"festivalTitle":{"type":"string"},"stageId":{"anyOf":[{"type":"string"},{"type":"null"}]},"stageName":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotStart":{"anyOf":[{"type":"string"},{"type":"null"}]},"isHeadliner":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["editionId","year","startDate","endDate","city","country","festivalId","festivalTitle","stageId","stageName","slotStart","isHeadliner"],"additionalProperties":false}}},"required":["oeuvreId","editions"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/albums":{"get":{"summary":"List albums with critic opinions","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationMinutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentionCount":{"type":"number"},"eventCount":{"type":"number"},"seanceCount":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","title","author","year","imageUrl","coverUrl","genres","description","durationMinutes","mentionCount","eventCount","seanceCount","createdAt","updatedAt"],"additionalProperties":false}},"count":{"type":"number"},"total":{"type":"number"}},"required":["data","count","total"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/albums/trending":{"get":{"summary":"Trending albums by recent critic mentions","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationMinutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentionCount":{"type":"number"},"eventCount":{"type":"number"},"seanceCount":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"score":{"type":"number"}},"required":["id","title","author","year","imageUrl","genres","description","durationMinutes","mentionCount","eventCount","seanceCount","createdAt","updatedAt","score"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/albums/featured":{"get":{"summary":"Editorially featured albums","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationMinutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentionCount":{"type":"number"},"eventCount":{"type":"number"},"seanceCount":{"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"richness":{"type":"number"}},"required":["id","title","author","year","imageUrl","genres","description","durationMinutes","mentionCount","eventCount","seanceCount","createdAt","updatedAt","richness"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/albums/{id}":{"get":{"summary":"Get a single album with critic opinions","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationMinutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"opinions":{"type":"array","items":{"type":"object","properties":{"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"sentiment":{"type":"string","enum":["very_positive","positive","mixed","negative","very_negative"],"description":"Never null: an opinion without a sentiment is not published."},"keyQuotes":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"episodeId":{"type":"string"},"episodeTitle":{"type":"string"},"audioUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"showName":{"type":"string"},"station":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"segmentStart":{"anyOf":[{"type":"number"},{"type":"null"}]},"segmentEnd":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["criticName","opinionSummary","sentiment","keyQuotes","episodeId","episodeTitle","audioUrl","showName","station","publishedAt","segmentStart","segmentEnd"],"additionalProperties":false}},"opinionCount":{"type":"number"},"eventCount":{"type":"number"},"seanceCount":{"type":"number"},"_links":{"type":"object","properties":{"recommendations":{"type":"string"},"similar":{"type":"string"},"opinions":{"type":"string"}},"required":["recommendations","similar","opinions"],"additionalProperties":false}},"required":["id","title","originalTitle","oeuvreType","year","author","description","genres","imageUrl","durationMinutes","createdAt","updatedAt","opinions","opinionCount","eventCount","seanceCount","_links"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/albums/{id}/similar":{"get":{"summary":"Find similar albums via vector search","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"durationMinutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"distance":{"type":"number"}},"required":["id","title","author","year","imageUrl","genres","description","durationMinutes","distance"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/trending":{"get":{"summary":"Trending curated content","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"cover_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"genre":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["album","podcastEpisode"]},"duration_minutes":{"anyOf":[{"type":"number"},{"type":"null"}]},"audio_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_context":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_event_title":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_venue_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_event_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"linked_oeuvre_ids":{"type":"array","items":{"type":"string"}},"linked_oeuvre_count":{"type":"number"},"score":{"type":"number"}},"required":["id","title","author","cover_url","genre","kind","duration_minutes","audio_url","description","source_context","source_event_title","source_venue_name","source_event_date","source_event_id","published_at","linked_oeuvre_ids","linked_oeuvre_count","score"],"additionalProperties":false}},"count":{"type":"number"},"kind":{"type":"string","enum":["album","podcastEpisode","all"]},"view":{"type":"string","enum":["default","compact"]}},"required":["data","count","kind","view"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/feed":{"get":{"summary":"Curated content feed","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"oeuvre":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvre_type":{"type":"string"},"director":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","oeuvre_type","director","author","publisher","year","genres","image_url","description"],"additionalProperties":false},"score":{"type":"number"},"signals":{"type":"object","properties":{"critic":{"type":"number"},"topicality":{"type":"number"},"urgency":{"type":"number"},"geo":{"type":"number"}},"required":["critic","topicality","urgency","geo"],"additionalProperties":false},"hook":{"type":"string"},"explainer":{"anyOf":[{"type":"string"},{"type":"null"}]},"top_opinion":{"anyOf":[{"type":"object","properties":{"critic_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"type":"string","minLength":1,"description":"Never null, never blank: an opinion without a summary is not published."},"sentiment":{"type":"string","enum":["very_positive","positive","mixed","negative","very_negative"],"description":"Never null: an opinion without a sentiment is not published."},"show":{"type":"string"},"key_quote":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["critic_name","summary","sentiment","show","key_quote"],"additionalProperties":false},{"type":"null"}]},"best_event":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_time":{"type":"string"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_free":{"type":"boolean"},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"buy_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","venue","start_time","end_time","price","is_free","distance_km","source_url","buy_url"],"additionalProperties":false},{"type":"null"}]},"nearest_seances":{"type":"array","items":{"type":"object","properties":{"venue":{"anyOf":[{"type":"string"},{"type":"null"}]},"distance_km":{"anyOf":[{"type":"number"},{"type":"null"}]},"start_time":{"type":"string"},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_free":{"type":"boolean"}},"required":["venue","distance_km","start_time","end_time","price","is_free"],"additionalProperties":false}}},"required":["category","oeuvre","score","signals","hook","explainer","top_opinion","best_event"],"additionalProperties":false}},"series_spotlight":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"recurrence":{"anyOf":[{"type":"string"},{"type":"null"}]},"upcoming_count":{"type":"number"},"next_start":{"type":"string"},"next_end":{"anyOf":[{"type":"string"},{"type":"null"}]},"venue_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"venue_lat":{"anyOf":[{"type":"number"},{"type":"null"}]},"venue_lng":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_free":{"anyOf":[{"type":"number"},{"type":"null"}]},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","description","recurrence","upcoming_count","next_start","next_end","venue_name","venue_lat","venue_lng","price","is_free","source_url","image_url","category"],"additionalProperties":false}},"trending_topics":{"type":"array","items":{"type":"string"}},"pagination":{"type":"object","properties":{"seed":{"type":"string"},"offset":{"type":"number"},"limit":{"type":"number"},"next_offset":{"type":"number"},"has_more":{"type":"boolean"},"total_pool":{"type":"number"}},"required":["seed","offset","limit","next_offset","has_more","total_pool"],"additionalProperties":false},"meta":{"type":"object","properties":{"generated_at":{"type":"string"},"explore":{"type":"number"},"location":{"anyOf":[{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"],"additionalProperties":false},{"type":"null"}]},"radius_km":{"type":"number"},"window":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},"categories":{"type":"array","items":{"type":"string"}},"view":{"type":"string","enum":["default","compact"]}},"required":["generated_at","explore","location","window","categories","view"],"additionalProperties":false}},"required":["data","series_spotlight","trending_topics","pagination","meta"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/sources":{"get":{"summary":"Catalogue of curated (featured) sources","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"showName":{"type":"string"},"station":{"type":"string"},"sourceType":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"featured":{"type":"boolean"},"venueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"tier":{"anyOf":[{"type":"string"},{"type":"null"}]},"credibilityScore":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","name","showName","station","sourceType","category","city","imageUrl","featured","venueId","tier","credibilityScore"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/sources/{id}/feed":{"get":{"summary":"Feed for a single curated source","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["events","mentions"]},"source":{"type":"object","properties":{"id":{"type":"string"},"showName":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"}},"required":["id","showName","sourceType"],"additionalProperties":false},"items":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isSoldOut":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","category","imageUrl","startTime","endTime","price","isFree","isSoldOut","sourceUrl","ticketUrl","buyUrl"],"additionalProperties":false},{"type":"object","properties":{"rawTitle":{"type":"string"},"oeuvreId":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}]},"criticName":{"anyOf":[{"type":"string"},{"type":"null"}]},"opinionSummary":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["rawTitle","oeuvreId","sentiment","criticName","opinionSummary","createdAt"],"additionalProperties":false,"description":"Editorial coverage item (what the source talked about), not an opinion object: opinionSummary and sentiment may be null."}]}},"count":{"type":"number"}},"required":["kind","source","items","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/sections":{"get":{"summary":"Server-driven curated app sections (ville × type)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"city":{"type":"string"},"kind":{"type":"string"},"title":{"type":"string"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentKind":{"type":"string"},"sortOrder":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","city","kind","title","subtitle","contentKind","sortOrder"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/sections/{id}/content":{"get":{"summary":"Content for a curated section","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content_kind":{"type":"string","enum":["events","venues"]},"data":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"isSoldOut":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"venue":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","city","latitude","longitude","venueType"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","description","category","imageUrl","startTime","endTime","price","isFree","isSoldOut","sourceUrl","ticketUrl","buyUrl","venue"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}]},"venueType":{"anyOf":[{"type":"string"},{"type":"null"}]},"venueCategories":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAttribution":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","address","city","latitude","longitude","venueType","venueCategories","website","imageUrl","imageAttribution"],"additionalProperties":false}]}},"count":{"type":"number"}},"required":["content_kind","data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/selection":{"get":{"summary":"Read this key's curated-source selection","tags":["culture"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sourceIds":{"type":"array","items":{"type":"string"}}},"required":["sourceIds"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/curation/selection/{sourceId}":{"post":{"summary":"Add a source to this key's curated selection","tags":["culture"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"delete":{"summary":"Remove a source from this key's curated selection","tags":["culture"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/public/embeddings/oeuvres":{"get":{"summary":"Delta-sync feed of oeuvre embedding vectors for on-device ranking (path is /public/embeddings, NOT /api/embeddings: no API key needed)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[{"name":"cursor","in":"query","required":false,"description":"Opaque pagination cursor from a previous response","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results per page","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/public/embeddings/curators":{"get":{"summary":"Delta-sync feed of curator (source) taste-vector centroids (path is /public/embeddings, NOT /api/embeddings: no API key needed)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[{"name":"cursor","in":"query","required":false,"description":"Opaque pagination cursor from a previous response","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results per page","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"embedding":{"type":"array","items":{"type":"number"}},"positiveCount":{"type":"number"},"updatedAt":{"type":"string"}},"required":["id","name","embedding","positiveCount","updatedAt"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"required":["data","nextCursor","hasMore"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/creators/instagram":{"get":{"summary":"Instagram creator signal (venue mentions extracted from IG captions)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"handle":{"type":"string"},"displayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"bioShort":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"profileUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vertical":{"anyOf":[{"type":"string"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"followerCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFeatured":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["id","handle","displayName","bioShort","avatarUrl","profileUrl","vertical","language","followerCount","isFeatured","createdAt"],"additionalProperties":false}},"count":{"type":"number"}},"required":["data","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/creators":{"get":{"summary":"List creators (directors, musicians, authors, etc.)","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"canonicalName":{"type":"string"},"creatorKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"birthYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"deathYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"bioPresent":{"type":"boolean"}},"required":["id","canonicalName","creatorKind","countryCode","genres","imageUrl","birthYear","deathYear","bioPresent"],"additionalProperties":false}},"count":{"type":"number"}},"required":["creators","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/creators/{id}":{"get":{"summary":"Get a single creator with bio and works","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creator":{"type":"object","properties":{"id":{"type":"string"},"canonicalName":{"type":"string"},"aliases":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"bioSource":{"anyOf":[{"type":"string"},{"type":"null"}]},"genres":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"merch":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"birthYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"deathYear":{"anyOf":[{"type":"number"},{"type":"null"}]},"wikipediaUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"wikidataId":{"anyOf":[{"type":"string"},{"type":"null"}]},"musicbrainzId":{"anyOf":[{"type":"string"},{"type":"null"}]},"tmdbPersonId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastEnrichedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","canonicalName","aliases","bio","bioSource","genres","label","merch","imageUrl","creatorKind","countryCode","birthYear","deathYear","wikipediaUrl","wikidataId","musicbrainzId","tmdbPersonId","lastEnrichedAt"],"additionalProperties":false},"works":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"oeuvreType":{"anyOf":[{"type":"string"},{"type":"null"}]},"year":{"anyOf":[{"type":"number"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["id","title","oeuvreType","year","description","imageUrl","role","confidence"],"additionalProperties":false}},"workCount":{"type":"number"}},"required":["creator","works","workCount"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/creators/{id}/events":{"get":{"summary":"Upcoming events linked to this creator's works","tags":["culture"],"x-stability":"beta","x-self-serve":true,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"startTime":{"type":"string"},"endTime":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticketUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"isFree":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}]},"venue":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","city"],"additionalProperties":false},{"type":"null"}]}},"required":["id","title","category","startTime","endTime","imageUrl","sourceUrl","ticketUrl","price","isFree","role","confidence","venue"],"additionalProperties":false}},"count":{"type":"number"}},"required":["events","count"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/feed":{"get":{"summary":"Football signal feed (transfers, injuries, lineups, quotes)","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[{"name":"discipline","in":"query","required":false,"description":"Discipline slug (football, rugby, cyclisme, athletisme, trail…); default football, `all` for every discipline","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"discipline":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"rawText":{"anyOf":[{"type":"string"},{"type":"null"}]},"entities":{"anyOf":[{},{"type":"null"}]},"sourceType":{"type":"string"},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePublishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorityScore":{"anyOf":[{"type":"number"},{"type":"null"}]},"programme":{"anyOf":[{"type":"string"},{"type":"null"}]},"storyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["id","kind","discipline","summary","rawText","entities","sourceType","sourceUrl","sourcePublishedAt","authorHandle","authorDisplayName","authorityScore","programme","storyId","createdAt"],"additionalProperties":false}},"meta":{"type":"object","properties":{"limit":{"type":"number"},"count":{"type":"number"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}]},"discipline":{"type":"string"}},"required":["limit","count","entity","discipline"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/feed/{id}":{"get":{"summary":"Get a single sport feed item","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/stories":{"get":{"summary":"Clustered football stories","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[{"name":"discipline","in":"query","required":false,"description":"Discipline slug (football, rugby, cyclisme, athletisme, trail…); default football, `all` for every discipline","schema":{"type":"string"}}],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/stories/{id}":{"get":{"summary":"Get a single football story","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/entities":{"get":{"summary":"Canonical football entities (players, clubs, competitions)","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/sport/results":{"get":{"summary":"Race results (running/trail/triathlon): race list, or one race's elite/consented results","tags":["sport"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/news/feed":{"get":{"summary":"Actu vertical signal feed (reformulated summaries, never raw text)","tags":["news"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/news/feed/{id}":{"get":{"summary":"Get a single news feed item","tags":["news"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/news/stories":{"get":{"summary":"Clustered news stories","tags":["news"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/news/stories/{id}":{"get":{"summary":"Get a single news story","tags":["news"],"x-stability":"beta","x-self-serve":false,"parameters":[],"security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"primaryKind":{"anyOf":[{"type":"string"},{"type":"null"}]},"entityTokens":{"type":"array","items":{"type":"string"}},"confidenceScore":{"type":"number"},"eventCount":{"type":"number"},"sourceCount":{"type":"number"},"firstSeenAt":{"type":"string"},"lastUpdateAt":{"type":"string"},"status":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string"},"label":{"type":"string"},"count":{"type":"number"}},"required":["sourceType","label","count"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourcePublishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"programme":{"anyOf":[{"type":"string"},{"type":"null"}]},"isLiveBlog":{"type":"boolean"},"createdAt":{"type":"string"},"factChecks":{"type":"array","items":{}}},"required":["id","kind","summary","sourceType","sourceUrl","sourcePublishedAt","authorDisplayName","programme","isLiveBlog","createdAt","factChecks"],"additionalProperties":false}},"consensus":{"description":"Consensus digest (claims corroborated across independent outlets). ABSENT when no digest has been built for this story. Built offline by build-news-consensus.ts; facts ordered by status (confirmed, contested, single_source), then informativeness, then independentSources. Clients must decode unknown facet/status values safely.","type":"object","properties":{"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"eventCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"independentSourceCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"facts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"claim":{"type":"string"},"facet":{"type":"string","enum":["programme","securite","affluence","politique","religieux","logistique","economie","justice","sante","autre"]},"status":{"type":"string","enum":["confirmed","single_source","contested"]},"independentSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"],"additionalProperties":false}},"informativeness":{"type":"number","minimum":0,"maximum":1}},"required":["id","claim","facet","status","independentSources","sources","informativeness"],"additionalProperties":false}},"contested":{"type":"array","items":{"type":"object","properties":{"subject":{"type":"string"},"versions":{"type":"array","items":{"type":"object","properties":{"claim":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"],"additionalProperties":false}}},"required":["claim","sources"],"additionalProperties":false}}},"required":["subject","versions"],"additionalProperties":false}}},"required":["generatedAt","eventCount","independentSourceCount","facts","contested"],"additionalProperties":false}},"required":["id","title","primaryKind","entityTokens","confidenceScore","eventCount","sourceCount","firstSeenAt","lastUpdateAt","status","sources","events"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Scope not granted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}}}}