{"openapi":"3.1.0","info":{"title":"SoundRadar Spotify Chart API","description":"Daily / Weekly Spotify chart API powered by SoundRadar chart snapshots.","version":"1.0.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/countries":{"get":{"summary":"Countries","operationId":"countries_api_spotify_countries_get","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/latest":{"get":{"summary":"Latest Chart","operationId":"latest_chart_api_spotify_latest_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"country code, e.g. global, us, kr, jp","default":"global","title":"Country"},"description":"country code, e.g. global, us, kr, jp"},{"name":"chart_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(daily|weekly)$","default":"daily","title":"Chart Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":200,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chart":{"get":{"summary":"Chart By Date","operationId":"chart_by_date_api_spotify_chart_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","default":"global","title":"Country"}},{"name":"chart_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(daily|weekly)$","default":"daily","title":"Chart Type"}},{"name":"chart_date","in":"query","required":true,"schema":{"type":"string","description":"YYYY-MM-DD","title":"Chart Date"},"description":"YYYY-MM-DD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":200,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dates":{"get":{"summary":"Available Dates","operationId":"available_dates_api_spotify_dates_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","default":"global","title":"Country"}},{"name":"chart_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(daily|weekly)$","default":"daily","title":"Chart Type"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search":{"get":{"summary":"Search Track","operationId":"search_track_api_spotify_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"chart_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(daily|weekly)$"},{"type":"null"}],"title":"Chart Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/history":{"get":{"summary":"Track History","operationId":"track_history_api_spotify_history_get","parameters":[{"name":"artist","in":"query","required":true,"schema":{"type":"string","title":"Artist"}},{"name":"title","in":"query","required":true,"schema":{"type":"string","title":"Title"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"chart_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(daily|weekly)$","default":"daily","title":"Chart Type"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fetch-logs":{"get":{"summary":"Fetch Logs","operationId":"fetch_logs_api_spotify_fetch_logs_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(success|failed|skipped)$"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"/spotify"}]}