{"openapi":"3.1.0","info":{"title":"GenrePulse API","version":"1.0.0","description":"Öffentliche, nur lesende API. Liefert ausschließlich vorberechnete Aggregationen. Rate Limit über Traefik. Fehlende Werte sind null, nie 0."},"servers":[{"url":"https://genre-platform.juan-canales.de"}],"paths":{"/api/v1/dashboard/overview":{"get":{"summary":"KPIs, Rankings je Medium, Quellenstatus","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres":{"get":{"summary":"Kanonische Genres (lokalisiert) mit Aliasen","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres/rankings":{"get":{"summary":"Popularity-Ranking je Medium","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres/trends":{"get":{"summary":"Genres mit Trend-Klasse","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres/compare":{"get":{"summary":"Bis zu 5 Genres vergleichen (g erforderlich)","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres/{id}":{"get":{"summary":"Ein Genre mit aktuellen Scores je Medium","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/genres/{id}/history":{"get":{"summary":"Verlauf eines Genres","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/media/{type}":{"get":{"summary":"Ranking + Top-Titel eines Mediums (movies|tv|books)","parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"}},{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/media/{type}/{id}":{"get":{"summary":"Ein Titel","parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/analytics/heatmap":{"get":{"summary":"Heatmap Genre × Periode (Veröffentlichungen, normalisiert)","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/analytics/momentum":{"get":{"summary":"Momentum je Genre (ab zwei Messpunkten)","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/analytics/seasonality":{"get":{"summary":"Saisonindex der Veröffentlichungen je Kalendermonat","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/sources/status":{"get":{"summary":"Status der Datenquellen","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/metadata/filters":{"get":{"summary":"Verfügbare Filterwerte","parameters":[{"name":"m","in":"query","schema":{"type":"string","enum":["all","movie","tv","book"],"default":"all"},"description":"Medium"},{"name":"p","in":"query","schema":{"type":"string","enum":["7d","30d","90d","6m","1y","3y","5y","all","custom"],"default":"5y"},"description":"Zeitraum"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"bei p=custom"},{"name":"r","in":"query","schema":{"type":"string","default":"global"},"description":"Region (v1: nur global belastbar)"},{"name":"g","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+(,[a-z0-9-]+){0,9}$"},"description":"Genre-Slugs, kommagetrennt"},{"name":"metric","in":"query","schema":{"type":"string","enum":["popularity","momentum","change","releases","search","share"],"default":"releases"}},{"name":"gran","in":"query","schema":{"type":"string","enum":["day","week","month","year"],"default":"month"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"],"default":"de"}},{"name":"top","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/v1/search":{"get":{"summary":"Suche Genres/Titel","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":80}},{"name":"lang","in":"query","schema":{"type":"string","enum":["de","en"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/health":{"get":{"summary":"Liveness","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}},"/api/ready":{"get":{"summary":"Readiness (DB)","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"apiVersion":{"const":"v1"}}}}}}}},"400":{"description":"Ungültige Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}}}}}}}}}}}