{"openapi":"3.0.0","info":{"title":"Soundcharts API","description":"Official Soundcharts API","version":"3.0.0"},"paths":{"\/api\/v2\/album\/by-uuid\/{uuid}":{"get":{"summary":"Get album metadata","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"b202abee-d19e-424e-9285-b420f4b98706","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.36\/album\/by-uuid\/{uuid}":{"get":{"summary":"Get album metadata","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"b202abee-d19e-424e-9285-b420f4b98706","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/album\/by-slug\/{slug}":{"get":{"summary":"Get album metadata (deprecated)","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"slug","in":"path","required":true,"description":"An album slug","schema":{"type":"string","default":"when-we-all-fall-asleep-where-do-we-go-1","pattern":"^[a-z0-9-]+$"}}]}},"\/api\/v2.15\/album\/by-slug\/{slug}":{"get":{"summary":"Get album metadata (deprecated)","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"slug","in":"path","required":true,"description":"An album slug","schema":{"type":"string","default":"when-we-all-fall-asleep-where-do-we-go-1","pattern":"^[a-z0-9-]+$"}}]}},"\/api\/v2\/album\/by-upc\/{upc}":{"get":{"summary":"Get album by UPC","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"upc","in":"path","required":true,"description":"An UPC code","schema":{"type":"string","default":"00602577427640"}}]}},"\/api\/v2.15\/album\/by-upc\/{upc}":{"get":{"summary":"Get album by UPC","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse4"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"upc","in":"path","required":true,"description":"An UPC code","schema":{"type":"string","default":"00602577427640"}}]}},"\/api\/v2.26\/album\/by-upc\/{upc}":{"get":{"summary":"Get album by UPC","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"upc","in":"path","required":true,"description":"An UPC code","schema":{"type":"string","default":"00602577427640"}}]}},"\/api\/v2.36\/album\/by-upc\/{upc}":{"get":{"summary":"Get album by UPC","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"upc","in":"path","required":true,"description":"An UPC code","schema":{"type":"string","default":"00602577427640"}}]}},"\/api\/v2\/album\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get album by platform ID","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse3"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A album platform Identifier.","schema":{"type":"string","default":"0S0KGZnfBGSIssfF54WSJh"}}]}},"\/api\/v2.15\/album\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get album by platform ID","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse4"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A album platform Identifier.","schema":{"type":"string","default":"0S0KGZnfBGSIssfF54WSJh"}}]}},"\/api\/v2.26\/album\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get album by platform ID","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A album platform Identifier.","schema":{"type":"string","default":"0S0KGZnfBGSIssfF54WSJh"}}]}},"\/api\/v2.36\/album\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get album by platform ID","responses":{"200":{"description":"An Album response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A album platform Identifier.","schema":{"type":"string","default":"0S0KGZnfBGSIssfF54WSJh"}}]}},"\/api\/v2.26\/album\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"b202abee-d19e-424e-9285-b420f4b98706","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"onlyDefault","in":"query","allowEmptyValue":true,"description":"Get only default identifier by platform","schema":{"type":"boolean","default":false}}]}},"\/api\/v2.26\/album\/{uuid}\/tracks":{"get":{"summary":"Get tracklisting","responses":{"200":{"description":"An Album track collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumTrackCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"b202abee-d19e-424e-9285-b420f4b98706","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/album\/{uuid}\/audience\/{platform}":{"get":{"summary":"Get audience","responses":{"200":{"description":"A album response with platform stream for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Album UUID","schema":{"type":"string","default":"63e0332f-5b4a-4828-83e3-d1178e51fd07","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD), leave empty to use latest 90 days","schema":{"type":"string","default":"2025-05-25"}},{"name":"identifier","in":"query","required":false,"description":"Optional album identifier (example : 2Fxmhks0bxGSBdJ92vM42m)","schema":{"type":"string","default":""}}]}},"\/api\/v2\/album\/{uuid}\/popularity\/{platform}":{"get":{"summary":"Get popularity","responses":{"200":{"description":"A album response popularity for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"63e0332f-5b4a-4828-83e3-d1178e51fd07","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2026-02-10"}}]}},"\/api\/v2.26\/album\/{uuid}\/charts\/ranks\/{platform}":{"get":{"summary":"Get chart entries","responses":{"200":{"description":"A album rank collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RankCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Album not found"}},"tags":["Album"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An album UUID","schema":{"type":"string","default":"436f0245-c0d0-43c0-a994-7c44568f482b","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A album chart platform code","schema":{"type":"string","default":"deezer"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in charts with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, rankDate","schema":{"type":"string","default":"position"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/top\/artists":{"post":{"summary":"Get artists (premium)","responses":{"200":{"description":"Top artist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopArtistCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Artist"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"followers","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"followers","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"countryCode","in":"query","required":false,"description":"Add a country to get artists ranked by their stats in that specific country. Avalaible values: country code of 2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2. Leave empty to get the artists list based on their global stats.","schema":{"type":"string","default":""}},{"name":"cityKey","in":"query","required":false,"description":"Add a cityKey and a countryCode to get artists ranked by their stats in that specific city. Available values are listed in the https:\/\/doc.api.soundcharts.com\/api\/v2\/doc\/reference\/path\/referential\/get-cities-for-artist-ranking endpoint.","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 500)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/artist\/{uuid}":{"get":{"summary":"Get artist metadata","responses":{"200":{"description":"An Artist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.9\/artist\/{uuid}":{"get":{"summary":"Get artist metadata","responses":{"200":{"description":"An Artist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/artist\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get artist by platform ID","responses":{"200":{"description":"An artist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No artist found for this platform identifier"}},"tags":["Artist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"An artist platform identifier","schema":{"type":"string","default":"6qqNVTkY8uBg9cP3Jd7DAH"}}]}},"\/api\/v2.9\/artist\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get artist by platform ID","responses":{"200":{"description":"An artist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No artist found for this platform identifier"}},"tags":["Artist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"An artist platform identifier","schema":{"type":"string","default":"6qqNVTkY8uBg9cP3Jd7DAH"}}]}},"\/api\/v2\/artist\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"onlyDefault","in":"query","allowEmptyValue":true,"description":"Get only default identifier by platform","schema":{"type":"boolean","default":false}}]}},"\/api\/v2\/artist\/{uuid}\/songs":{"get":{"summary":"Get songs","responses":{"200":{"description":"An Artist song collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"You are not authorized to perform this operation"},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : name, releaseDate, spotifyStream, shazamCount, youtubeViews, spotifyPopularity, soundchartsScore","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.21\/artist\/{uuid}\/songs":{"get":{"summary":"Get songs","responses":{"200":{"description":"An Artist song collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"You are not authorized to perform this operation"},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : name, releaseDate, spotifyStream, shazamCount, youtubeViews, spotifyPopularity, soundchartsScore","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/albums":{"get":{"summary":"Get albums","responses":{"200":{"description":"An Artist album collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : title, releaseDate","schema":{"type":"string","default":"title"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.18\/artist\/{uuid}\/albums":{"get":{"summary":"Get albums","responses":{"200":{"description":"An Artist album collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : title, releaseDate","schema":{"type":"string","default":"title"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.26\/artist\/{uuid}\/albums":{"get":{"summary":"Get albums","responses":{"200":{"description":"An Artist album collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumCollectionResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : title, releaseDate","schema":{"type":"string","default":"title"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.34\/artist\/{uuid}\/albums":{"get":{"summary":"Get albums","responses":{"200":{"description":"An Artist album collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumCollectionResponse4"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"type","in":"query","description":"Filter result album list. Available values are : all, album, single, compil","schema":{"type":"string","default":"all"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : title, releaseDate","schema":{"type":"string","default":"title"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/related":{"get":{"summary":"Get similar artists","responses":{"200":{"description":"An Artist Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/current\/stats":{"get":{"summary":"Get current stats (premium)","responses":{"200":{"description":"Current stats response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CurrentStatsResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"period","in":"query","description":"Period","schema":{"type":"string","default":"7"}}]}},"\/api\/v2\/artist\/{uuid}\/soundcharts\/score":{"get":{"summary":"Get Soundcharts score","responses":{"200":{"description":"A Sounddcharts Score response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SoundchartsScoreCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2025-03-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/audience\/{platform}":{"get":{"summary":"Get audience","responses":{"200":{"description":"A Social Account response along with its audience plots","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudiencePlotCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"instagram"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-09-24"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.37\/artist\/{uuid}\/social\/{platform}\/followers\/":{"get":{"summary":"Get local audience","responses":{"200":{"description":"A Social Account response along with its data plots","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SocialPlotCollectionResponse"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"ca22091a-3c00-11e9-974f-549f35141000","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"instagram"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/social\/{platform}":{"get":{"summary":"Get followers (deprecated)","responses":{"200":{"description":"A Social Account response along with its data plots","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SocialPlotCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/streaming\/{platform}\/listening":{"get":{"summary":"Get streaming audience","responses":{"200":{"description":"Global platform listening audience for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GlobalAudiencePlotCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"ca22091a-3c00-11e9-974f-549f35141000","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-09-24"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/streaming\/{platform}":{"get":{"summary":"Get local streaming audience","responses":{"200":{"description":"A Local Streaming Audience","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/StreamingPlotCollectionResponse"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A streaming platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-09-24"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/{platform}\/retention":{"get":{"summary":"Get retention","responses":{"200":{"description":"Retention for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RetentionPlotCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code (spotify, jiosaavn, anghami, youtube, audiomack, yandex)","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/popularity\/{platform}":{"get":{"summary":"Get popularity","responses":{"200":{"description":"A Streaming Account response with platform popularity for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PopularityPlotCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/audience\/{platform}\/report\/latest":{"get":{"summary":"Get audience report - latest","responses":{"200":{"description":"An Artist audience report response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudienceReportResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"instagram"}}]}},"\/api\/v2\/artist\/{uuid}\/audience\/{platform}\/report\/available-dates":{"get":{"summary":"Get audience report dates","responses":{"200":{"description":"An audience report listing dates collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudienceReportDateCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"instagram"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/audience\/{platform}\/report\/{date}":{"get":{"summary":"Get audience report for a date","responses":{"200":{"description":"An Artist audience report response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudienceReportResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A social platform code","schema":{"type":"string","default":"instagram"}},{"name":"date","in":"path","required":true,"description":"A report date (YYYY-MM-DD)","schema":{"type":"string","default":"2020-09-20","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}]}},"\/api\/v2\/artist\/{uuid}\/shorts\/{platform}\/videos":{"get":{"summary":"Get short videos","responses":{"200":{"description":"A social video collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SocialVideoCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A platform code (instagram, youtube)","schema":{"type":"string","default":"instagram"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/shorts\/{identifier}\/audience":{"get":{"summary":"Get short video audience","responses":{"200":{"description":"A Short video Audience collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudienceCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Short Video not found"}},"tags":["Artist"],"parameters":[{"name":"identifier","in":"path","required":true,"description":"A short\/reel\/video identifier","schema":{"type":"string","default":"C74VMlhOf6K"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/charts\/song\/ranks\/{platform}":{"get":{"summary":"Get chart song entries","responses":{"200":{"description":"An Artist Chart Song Ranks response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RankCollectionResponse2"}}}},"400":{"description":"Invalid platform code provided"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"ca22091a-3c00-11e9-974f-549f35141000","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"An Artist Chart platform code","schema":{"type":"string","default":"spotify"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in charts with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, rankDate","schema":{"type":"string","default":"position"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/charts\/album\/ranks\/{platform}":{"get":{"summary":"Get chart album entries","responses":{"200":{"description":"An Artist Chart Album Ranks response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumRankCollectionResponse"}}}},"400":{"description":"Invalid platform code provided"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"An Artist Chart album platform code","schema":{"type":"string","default":"deezer"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in charts with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, rankDate","schema":{"type":"string","default":"position"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.28\/artist\/{uuid}\/charts\/album\/ranks\/{platform}":{"get":{"summary":"Get chart album entries","responses":{"200":{"description":"An Artist Chart Album Ranks response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumRankCollectionResponse2"}}}},"400":{"description":"Invalid platform code provided"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"An Artist Chart album platform code","schema":{"type":"string","default":"deezer"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in charts with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, rankDate","schema":{"type":"string","default":"position"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/playlist\/current\/{platform}":{"get":{"summary":"Get playlist entries","responses":{"200":{"description":"An Artist Track Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist Not Found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A playlist type. Available values are : 'all' or one of editorial, algorithmic, algotorial, major, charts, curators_listeners, radios, this_is","schema":{"type":"string","default":"all"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in playlist with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, positionDate, entryDate, subscriberCount","schema":{"type":"string","default":"entryDate"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"desc"}}]}},"\/api\/v2.20\/artist\/{uuid}\/playlist\/current\/{platform}":{"get":{"summary":"Get playlist entries","responses":{"200":{"description":"An Artist Track Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist Not Found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A playlist type. Available values are : 'all' or one of editorial, algorithmic, algotorial, major, charts, curators_listeners, radios, this_is","schema":{"type":"string","default":"all"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in playlist with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"playlistUuids","in":"query","allowEmptyValue":true,"description":"Playlist UUID separed with comma. Example : f31dc337-b8b6-43d5-bd44-527b80e1d56a,1ac5da74-64c3-4266-92a8-60bbb589a01d","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, positionDate, entryDate, subscriberCount","schema":{"type":"string","default":"entryDate"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"desc"}}]}},"\/api\/v2\/artist\/{uuid}\/playlist\/reach\/{platform}":{"get":{"summary":"Get playlist reach","responses":{"200":{"description":"A Playlist Reach Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistReachCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist Not Found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"Available values are : 'all' or one of editorial, user, algorithmic","schema":{"type":"string","default":"all"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2025-05-25"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/broadcasts":{"get":{"summary":"Get radio spins","responses":{"200":{"description":"A Broadcast Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BroadcastCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"radioSlugs","in":"query","allowEmptyValue":true,"description":"Optional radio slugs filter (comma separated)","schema":{"type":"string","default":"bbc-2,bbc-london"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Optional country code filter (2 letters ISO 3166-2, full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":""}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/broadcast-groups":{"get":{"summary":"Get radio spin count","responses":{"200":{"description":"A Broadcast Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BroadcastCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Arist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An Artist  UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"radioSlugs","in":"query","allowEmptyValue":true,"description":"Optional radio slugs filter (comma separated)","schema":{"type":"string","default":"bbc-2,bbc-london"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Optional country code filter (2 letters ISO 3166-2, full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":""}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/{uuid}\/songkick\/events":{"get":{"summary":"Get Songkick events (deprecated)","responses":{"200":{"description":"Songkick event collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EventCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A period type (Available values are : all, concert, festival)","schema":{"type":"string","default":"all"}},{"name":"periodType","in":"query","allowEmptyValue":true,"required":false,"description":"A period type (Available values are : all, past, upcoming)","schema":{"type":"string","default":"all"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : date","schema":{"type":"string","default":"date"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.19\/artist\/{uuid}\/songkick\/events":{"get":{"summary":"Get Songkick events (deprecated)","responses":{"200":{"description":"Songkick event collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EventCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"Type of the events (Available values are : all, concert, festival)","schema":{"type":"string","default":"all"}},{"name":"periodType","in":"query","allowEmptyValue":true,"required":false,"description":"A period type (Available values are : all, past, upcoming)","schema":{"type":"string","default":"all"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : date","schema":{"type":"string","default":"date"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/events":{"get":{"summary":"Get events","responses":{"200":{"description":"Artist Event collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistEventCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Artist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A period type (Available values are : all, concert, festival, online)","schema":{"type":"string","default":"all"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : date","schema":{"type":"string","default":"date"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/artist\/{uuid}\/sources\/add":{"post":{"summary":"Add links","responses":{"200":{"description":"An Artist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"},"405":{"description":"Sandbox only. This operation is not allowed on sandbox environment"}},"tags":["Artist"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"urls":{"items":{"example":"https:\/\/open.spotify.com\/artist\/3TVXtAsR1Inumwj472S9r4","type":"string"},"type":"array"}},"type":"object"}}}},"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcc-9c1c-ce38-b96b-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/artist\/{uuid}\/contacts":{"get":{"summary":"Get contacts (premium)","responses":{"200":{"description":"An Artist contact collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ContactCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Artist not found"}},"tags":["Private"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An artist UUID","schema":{"type":"string","default":"11e81bcd-a62c-3962-90de-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/top-song\/{platform}\/{metricType}":{"get":{"summary":"Get song ranking (deprecated)","responses":{"200":{"description":"A Top Song response with platform audience, popularity, custom ... for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopSongCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Charts"],"parameters":[{"name":"platform","in":"path","required":true,"description":"platform code","schema":{"type":"string","default":"spotify"}},{"name":"metricType","in":"path","required":true,"description":"streams, views, videos created, favorites, popularity, plays, likes, count","schema":{"type":"string","default":"streams"}},{"name":"sortBy","in":"query","required":true,"description":"total, change, percent","schema":{"type":"string","default":"total"}},{"name":"period","in":"query","required":true,"description":"week, month, quarter","schema":{"type":"string","default":"week"}},{"name":"songCountryCode","in":"query","required":false,"description":"Song nationality (Country code of 2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":""}},{"name":"minValue","in":"query","required":false,"description":"Total audience (min value)","schema":{"type":"integer","default":"0"}},{"name":"maxValue","in":"query","required":false,"description":"Total audience (max value)","schema":{"type":"integer","default":"150000000"}},{"name":"minChange","in":"query","required":false,"description":"Change percentage audience (min value)","schema":{"type":"integer","default":"-100"}},{"name":"maxChange","in":"query","required":false,"description":"Change percentage audience (max value)","schema":{"type":"integer","default":"150000000"}},{"name":"token","in":"query","required":false,"description":"Page token","schema":{"type":"string","default":""}}]}},"\/api\/v2\/top-radio\/{platform}\/{metricType}":{"get":{"summary":"Get radio ranking (deprecated)","responses":{"200":{"description":"A Top Radio response with platform followers\/fan\/likes\/subscribres ... for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopBroadcastCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Charts"],"parameters":[{"name":"platform","in":"path","required":true,"description":"platform code","schema":{"type":"string","default":"instagram"}},{"name":"metricType","in":"path","required":true,"description":"fans, followers, reach","schema":{"type":"string","default":"followers"}},{"name":"sortBy","in":"query","required":true,"description":"total, change, percent","schema":{"type":"string","default":"total"}},{"name":"period","in":"query","required":true,"description":"month, quarter","schema":{"type":"string","default":"month"}},{"name":"radioCountryCode","in":"query","required":false,"description":"Radio nationality (Country code of 2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":""}},{"name":"minValue","in":"query","required":false,"description":"Total audience (min value)","schema":{"type":"integer","default":"0"}},{"name":"maxValue","in":"query","required":false,"description":"Total audience (max value)","schema":{"type":"integer","default":"150000000"}},{"name":"minChange","in":"query","required":false,"description":"Change percentage audience (min value)","schema":{"type":"integer","default":"-100"}},{"name":"maxChange","in":"query","required":false,"description":"Change percentage audience (max value)","schema":{"type":"integer","default":"150000000"}},{"name":"token","in":"query","required":false,"description":"Page token","schema":{"type":"string","default":""}}]}},"\/api\/v2\/chart\/song\/by-platform\/{platform}":{"get":{"summary":"Get song chart list by platform","responses":{"200":{"description":"A Song Chart Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Platform not found"}},"tags":["Charts"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A song chart platform code","schema":{"type":"string","default":"spotify"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/song\/{slug}\/ranking\/latest":{"get":{"summary":"Get song ranking - latest","responses":{"200":{"description":"A Song Chart Rank Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartSongRankCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A song chart slug","schema":{"type":"string","default":"global-28"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.14\/chart\/song\/{slug}\/ranking\/latest":{"get":{"summary":"Get song ranking - latest","responses":{"200":{"description":"A Song Chart Rank Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartSongRankCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A song chart slug","schema":{"type":"string","default":"global-28"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/song\/{slug}\/available-rankings":{"get":{"summary":"Get song ranking dates","responses":{"200":{"description":"A Chart Ranking Dates Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AvailableRankingCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A song chart slug","schema":{"type":"string","default":"global-28"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/song\/{slug}\/ranking\/{datetime}":{"get":{"summary":"Get song ranking for a date","responses":{"200":{"description":"A song chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartSongRankCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"global-28"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-06T18:00:01+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.14\/chart\/song\/{slug}\/ranking\/{datetime}":{"get":{"summary":"Get song ranking for a date","responses":{"200":{"description":"A song chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartSongRankCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"global-28"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-06T18:00:01+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/album\/by-platform\/{platform}":{"get":{"summary":"Get album chart list by platform","responses":{"200":{"description":"An Album Chart Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Platform not found"}},"tags":["Charts"],"parameters":[{"name":"platform","in":"path","required":true,"description":"An album chart platform code","schema":{"type":"string","default":"deezer"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/album\/{slug}\/ranking\/latest":{"get":{"summary":"Get album ranking - latest","responses":{"200":{"description":"An album chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartAlbumRankCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"top-200-metal"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.26\/chart\/album\/{slug}\/ranking\/latest":{"get":{"summary":"Get album ranking - latest","responses":{"200":{"description":"An album chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartAlbumRankCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"top-200-metal"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/album\/{slug}\/available-rankings":{"get":{"summary":"Get album ranking dates","responses":{"200":{"description":"A Chart Ranking Dates Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AvailableRankingCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"top-200-metal"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/album\/{slug}\/ranking\/{datetime}":{"get":{"summary":"Get album ranking for a date","responses":{"200":{"description":"An album chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartAlbumRankCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"top-200-metal"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-10T14:30:02+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.26\/chart\/album\/{slug}\/ranking\/{datetime}":{"get":{"summary":"Get album ranking for a date","responses":{"200":{"description":"An album chart ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ChartAlbumRankCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Chart not found"}},"tags":["Charts"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A chart slug","schema":{"type":"string","default":"top-200-metal"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-10T14:30:02+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/tiktok\/music\/weekly\/ranking\/latest":{"get":{"summary":"Get TikTok music links ranking - latest (premium)","responses":{"200":{"description":"A TikTok Rank Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TiktokMusicRankCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Charts"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/tiktok\/music\/weekly\/available-rankings":{"get":{"summary":"Get TikTok music links ranking dates (premium)","responses":{"200":{"description":"A TikTok Ranking Dates Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AvailableTiktokMusicRankingCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Charts"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/chart\/tiktok\/music\/weekly\/ranking\/{datetime}":{"get":{"summary":"Get TikTok music links ranking for a date (premium)","responses":{"200":{"description":"A TikTok Rank Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TiktokMusicRankCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Charts"],"parameters":[{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2021-05-02T00:00:00+02:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/collaborator\/{uuid}":{"get":{"summary":"Get collaborator metadata","responses":{"200":{"description":"A collaborator response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CollaboratorResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Collaborator not found"}},"tags":["Collaborator"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A collaborator UUID","schema":{"type":"string","default":"87614bd2-2007-4d3c-8142-a1490d50674b","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/collaborator\/by-ipi\/{ipi}":{"get":{"summary":"Get collaborator by IPI","responses":{"200":{"description":"A collaborator response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CollaboratorResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Collaborator not found"}},"tags":["Collaborator"],"parameters":[{"name":"ipi","in":"path","required":true,"description":"A Collaborator IPI","schema":{"type":"string","default":"00804356845"}}]}},"\/api\/v2\/collaborator\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get collaborator by platform ID","responses":{"200":{"description":"A collaborator response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CollaboratorResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Collaborator not found"}},"tags":["Collaborator"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A collaborator platform Identifier.","schema":{"type":"string","default":"6qqNVTkY8uBg9cP3Jd7DAH"}}]}},"\/api\/v2\/collaborator\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CollaboratorIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Collaborator not found"}},"tags":["Collaborator"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A collaborator UUID","schema":{"type":"string","default":"87614bd2-2007-4d3c-8142-a1490d50674b","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/top\/festivals":{"post":{"summary":"Get festivals (premium)","responses":{"200":{"description":"Top festival collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopFestivalCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Festival"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"x","type":"string"},"metricType":{"example":"followers","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"x","type":"string"},"metricType":{"example":"followers","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/festival\/{uuid}":{"get":{"summary":"Get festival metadata","responses":{"200":{"description":"A festival response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FestivalResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Festival not found"}},"tags":["Festival"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A festival UUID","schema":{"type":"string","default":"102cd0ba-1d58-449c-9abf-0960c1a3b5ba","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/festival\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get festival by platform ID","responses":{"200":{"description":"A festival response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FestivalResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Festival not found"}},"tags":["Festival"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"instagram"}},{"name":"identifier","in":"path","required":true,"description":"A festival platform identifier","schema":{"type":"string","default":"coachella"}}]}},"\/api\/v2\/festival\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FestivalIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Festival not found"}},"tags":["Festival"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A festival UUID","schema":{"type":"string","default":"102cd0ba-1d58-449c-9abf-0960c1a3b5ba","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/festival\/{uuid}\/editions":{"get":{"summary":"Get editions","responses":{"200":{"description":"An event collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EditionCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Festival"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A festival UUID","schema":{"type":"string","default":"102cd0ba-1d58-449c-9abf-0960c1a3b5ba","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/festival\/edition\/{uuid}":{"get":{"summary":"Get edition details","responses":{"200":{"description":"An event response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EditionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Festival"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"An edition UUID","schema":{"type":"string","default":"fc90a165-b81e-48bd-aea3-a8e7a5f00e18","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/library\/artist":{"get":{"summary":"Get artist list","responses":{"200":{"description":"A artist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistIdentifierCollectionResponse2"}}}}},"tags":["My Library"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]},"post":{"summary":"Add artists IDs","responses":{"200":{"description":"An IdentifierSubmitted response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/IdentifiersSubmittedResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["My Library"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"identifiers":{"items":{"properties":{"identifier":{"example":"9635624","type":"string"},"platformCode":{"example":"deezer","type":"string"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}}},"delete":{"summary":"Delete artists IDs","responses":{"200":{"description":"An IdentifierSubmitted response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/IdentifiersSubmittedResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["My Library"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"identifiers":{"items":{"properties":{"identifier":{"example":"9635624","type":"string"},"platformCode":{"example":"deezer","type":"string"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}}}},"\/api\/v2\/library\/song":{"get":{"summary":"Get song list","responses":{"200":{"description":"A artist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongIdentifierCollectionResponse"}}}}},"tags":["My Library"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]},"post":{"summary":"Add songs IDs","responses":{"200":{"description":"A SongSubmitted response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/IdentifiersSubmittedResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["My Library"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"identifiers":{"items":{"properties":{"identifier":{"example":"1577594494","type":"string"},"platformCode":{"example":"apple-music","type":"string"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}}},"delete":{"summary":"Delete songs IDs","responses":{"200":{"description":"A SongSubmitted response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/IdentifiersSubmittedResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["My Library"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"identifiers":{"items":{"properties":{"identifier":{"example":"1577594494","type":"string"},"platformCode":{"example":"apple-music","type":"string"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}}}},"\/api\/v2\/top\/playlists\/{platform}":{"post":{"summary":"Get playlists (premium)","responses":{"200":{"description":"Top Playlist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopPlaylistCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Playlist"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"likes","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"likes","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 500)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/playlist\/{uuid}":{"get":{"summary":"Get playlist metadata","responses":{"200":{"description":"A playlist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"86694fd0-cdce-11e8-8cff-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.8\/playlist\/{uuid}":{"get":{"summary":"Get playlist metadata","responses":{"200":{"description":"A playlist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"86694fd0-cdce-11e8-8cff-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/playlist\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get playlist by platform ID","responses":{"200":{"description":"A playlist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No playlist found for this platform identifier"}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A playlist identifier","schema":{"type":"string","default":"37i9dQZF1DWXJfnUiYjUKT"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}}]}},"\/api\/v2.8\/playlist\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get playlist by platform ID","responses":{"200":{"description":"A playlist response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No playlist found for this platform identifier"}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A playlist identifier","schema":{"type":"string","default":"37i9dQZF1DWXJfnUiYjUKT"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}}]}},"\/api\/v2\/playlist\/curators\/{platform}":{"get":{"summary":"Get curators by platform","responses":{"200":{"description":"A playlist owner collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/OwnerCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Platform not found"}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/playlist\/by-curator\/{platform}\/{curatorIdentifier}":{"get":{"summary":"Get playlists by curator","responses":{"200":{"description":"A playlist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Curator not found"}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"curatorIdentifier","in":"path","required":true,"description":"A playlist curator identifier","schema":{"type":"string","default":"spotify"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : audience, name","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2.20\/playlist\/by-curator\/{platform}\/{curatorIdentifier}":{"get":{"summary":"Get playlists by curator","responses":{"200":{"description":"A playlist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistCollectionResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Curator not found"}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"curatorIdentifier","in":"path","required":true,"description":"A playlist curator identifier","schema":{"type":"string","default":"spotify"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : audience, name","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/playlist\/by-type\/{platform}\/{type}":{"get":{"summary":"Get playlists by type","responses":{"200":{"description":"A playlist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistCollectionResponse3"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"path","required":true,"description":"A playlist type (algorithmic, charts, curators_listeners, editorial, algotorial, major, radios, this_is.)","schema":{"type":"string","default":"editorial"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : audience, name","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/playlist\/{uuid}\/audience":{"get":{"summary":"Get audience","responses":{"200":{"description":"A playlist audience plots collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudiencePlotCollectionResponse2"}}}},"400":{"description":"Invalid period"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","required":false,"description":"Period start date (Format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":"2020-10-01"}},{"name":"endDate","in":"query","required":false,"description":"Period end date (Format YYYY-MM-DD).","schema":{"type":"string","default":"2020-10-10"}}]}},"\/api\/v2.20\/playlist\/{uuid}\/audience":{"get":{"summary":"Get audience","responses":{"200":{"description":"A playlist audience plots collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AudiencePlotCollectionResponse3"}}}},"400":{"description":"Invalid period"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","required":false,"description":"Period start date (Format YYYY-MM-DD). Example : 2019-01-31","schema":{"type":"string","default":"2020-10-01"}},{"name":"endDate","in":"query","required":false,"description":"Period end date (Format YYYY-MM-DD). Example : 2019-01-31","schema":{"type":"string","default":"2020-10-10"}}]}},"\/api\/v2.20\/playlist\/by-type\/{platform}\/{type}":{"get":{"summary":"Get playlists by type","responses":{"200":{"description":"A playlist collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistCollectionResponse4"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Playlist"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"path","required":true,"description":"A playlist type (algorithmic, charts, curators_listeners, editorial, algotorial, major, radios, this_is.)","schema":{"type":"string","default":"editorial"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2). Required for apple-music and amazon","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : audience, name","schema":{"type":"string","default":"name"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/playlist\/{uuid}\/tracks\/latest":{"get":{"summary":"Get tracklisting - latest","responses":{"200":{"description":"A playlist track collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.20\/playlist\/{uuid}\/tracks\/latest":{"get":{"summary":"Get tracklisting - latest","responses":{"200":{"description":"A playlist track collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse4"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/playlist\/{uuid}\/available-tracklistings":{"get":{"summary":"Get tracklisting dates","responses":{"200":{"description":"A playlist track listing dates collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TracklistingDateCollectionResponse"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"endDate","in":"query","required":false,"description":"Optional period filter (YYYY-MM-DD format)","schema":{"type":"string","default":"2020-10-10","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"period","in":"query","required":false,"description":"Number of historical days","schema":{"type":"integer","default":"30"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.20\/playlist\/{uuid}\/available-tracklistings":{"get":{"summary":"Get tracklisting dates","responses":{"200":{"description":"A playlist track listing dates collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TracklistingDateCollectionResponse2"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"endDate","in":"query","required":false,"description":"Optional period filter (YYYY-MM-DD format)","schema":{"type":"string","default":"2020-10-10","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"period","in":"query","required":false,"description":"Number of historical days (max. 90)","schema":{"type":"integer","default":"30"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/playlist\/{uuid}\/tracks\/{datetime}":{"get":{"summary":"Get tracklisting for a date","responses":{"200":{"description":"A playlist track collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse3"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-15T05:25:01+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.20\/playlist\/{uuid}\/tracks\/{datetime}":{"get":{"summary":"Get tracklisting for a date","responses":{"200":{"description":"A playlist track collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TrackCollectionResponse4"}}}},"400":{"description":"Invalid date provided"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Playlist not found"}},"tags":["Playlist"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A playlist UUID","schema":{"type":"string","default":"11e84493-4135-a14e-bca2-a0369fe50396","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"datetime","in":"path","required":true,"description":"A ranking date (ATOM format)","schema":{"type":"string","default":"2020-10-15T05:25:01+00:00","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\+\\d{2}:\\d{2}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/publisher\/{uuid}":{"get":{"summary":"Get publisher metadata","responses":{"200":{"description":"A Publisher response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PublisherResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Publisher not found"}},"tags":["Publisher"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Publisher UUID","schema":{"type":"string","default":"0a552a9d-a4d0-4469-9d42-b02458a73168","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/publisher\/by-ipi\/{ipi}":{"get":{"summary":"Get publisher by IPI","responses":{"200":{"description":"A publisher response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PublisherResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Publisher not found"}},"tags":["Publisher"],"parameters":[{"name":"ipi","in":"path","required":true,"description":"A Publisher platform Identifier.","schema":{"type":"string","default":"00832425062"}}]}},"\/api\/v2\/publisher\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get publisher by platform ID","responses":{"200":{"description":"A publisher response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PublisherResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Publisher not found"}},"tags":["Publisher"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"mlc"}},{"name":"identifier","in":"path","required":true,"description":"A Publisher platform Identifier.","schema":{"type":"string","default":"7786878"}}]}},"\/api\/v2\/publisher\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PublisherIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Publisher not found"}},"tags":["Publisher"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Publisher UUID","schema":{"type":"string","default":"0a552a9d-a4d0-4469-9d42-b02458a73168","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/top\/radios":{"post":{"summary":"Get radios","responses":{"200":{"description":"Top radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopRadioCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Radio"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"soundcharts","type":"string"},"metricType":{"example":"reach","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"soundcharts","type":"string"},"metricType":{"example":"reach","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 500)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/radio":{"get":{"summary":"Get radios (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse"}}}}},"tags":["Radio"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.18\/radio":{"get":{"summary":"Get radios (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse2"}}}}},"tags":["Radio"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.22\/radio":{"get":{"summary":"Get radios (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse3"}}}}},"tags":["Radio"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/radio\/by-country\/{countryCode}":{"get":{"summary":"Get radios by country (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse"}}}},"400":{"description":"Invalid request"}},"tags":["Radio"],"parameters":[{"name":"countryCode","in":"path","required":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":"GB"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.18\/radio\/by-country\/{countryCode}":{"get":{"summary":"Get radios by country (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse2"}}}},"400":{"description":"Invalid request"}},"tags":["Radio"],"parameters":[{"name":"countryCode","in":"path","required":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":"GB"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2.22\/radio\/by-country\/{countryCode}":{"get":{"summary":"Get radios by country (deprecated)","responses":{"200":{"description":"A radio collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse3"}}}},"400":{"description":"Invalid request"}},"tags":["Radio"],"parameters":[{"name":"countryCode","in":"path","required":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":"GB"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/radio\/{slug}\/live-feed":{"get":{"summary":"Get live feed","responses":{"200":{"description":"A live feed collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LiveFeedCollectionResponse"}}}}},"tags":["Radio"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A radio slug","schema":{"type":"string","default":"bbc-2","pattern":"^[a-z0-9-]+$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/radio\/{slug}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioIdentifierCollectionResponse"}}}}},"tags":["Radio"],"parameters":[{"name":"slug","in":"path","required":true,"description":"A radio slug","schema":{"type":"string","default":"bbc-2","pattern":"^[a-z0-9-]+$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/referential\/platforms":{"get":{"summary":"Get platforms","responses":{"200":{"description":"A platform collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/referential\/platforms\/social":{"get":{"summary":"Get platforms for audience data","responses":{"200":{"description":"A social platforms collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/referential\/platforms\/streaming":{"get":{"summary":"Get platforms for streaming data","responses":{"200":{"description":"A streaming platforms collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/chart\/song\/platforms":{"get":{"summary":"Get platforms for song charts","responses":{"200":{"description":"A chart song platforms collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/chart\/album\/platforms":{"get":{"summary":"Get platforms for album charts","responses":{"200":{"description":"A chart album platforms collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/playlist\/platforms":{"get":{"summary":"Get platforms for playlist data","responses":{"200":{"description":"A playlist platforms collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlatformCollectionResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/radio\/countries":{"get":{"summary":"Get radio country list","responses":{"200":{"description":"A country collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CountryCollectionResponse"}}}}},"tags":["Referential"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/genres":{"get":{"summary":"Get artist genres","responses":{"200":{"description":"A Genre and sub Genre collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GenreCollectionResponse"}}}}},"tags":["Referential"],"parameters":[{"name":"genre","in":"query","description":"Artist genre","schema":{"type":"string","default":"all"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/top-artist\/referential\/cities\/{countryCode}":{"get":{"summary":"Get cities for artist ranking","responses":{"200":{"description":"A City ranking collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CityCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Referential"],"parameters":[{"name":"countryCode","in":"path","required":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string","default":"FR"}},{"name":"searchCity","in":"query","required":false,"description":"Search city filter","schema":{"type":"string","default":"Paris"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/referential\/song\/genres":{"get":{"summary":"Get song genres","responses":{"200":{"description":"A Genre and sub Genre collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GenreCollectionResponse"}}}}},"tags":["Referential"],"parameters":[{"name":"genre","in":"query","description":"Song genre","schema":{"type":"string","default":"all"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/referential\/label-types":{"get":{"summary":"Get label types","responses":{"200":{"description":"A label type collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LabelTypesResponse"}}}}},"tags":["Referential"]}},"\/api\/v2\/referential\/distributors":{"get":{"summary":"Get distributors","responses":{"200":{"description":"A Distributor collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DistributorCollectionResponse"}}}}},"tags":["Referential"],"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/referential\/lyrics-attributes":{"get":{"summary":"Get lyrics attributes","responses":{"200":{"description":"A lyrics attributes collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LyricsAttributesCollectionResponse"}}}}},"tags":["Referential"],"parameters":[{"name":"attribute","in":"query","required":true,"description":"themes, moods, culturalReferencePeople, culturalReferenceNonPeople, brands, locations","schema":{"type":"string","default":"themes"}},{"name":"term","in":"query","description":"Term to search item which contains term","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/artist\/search\/{term}":{"get":{"summary":"Search artist by name","responses":{"200":{"description":"An artist collection response with the 20 most pertinent artists","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No artist found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name or an identifier","schema":{"type":"string","default":"Billie Eilish","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/song\/search\/{term}":{"get":{"summary":"Search song by name","responses":{"200":{"description":"A song collection response with the 20 most pertinent songs","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongCollectionResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No song found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name or an identifier","schema":{"type":"string","default":"let\u2019s dance david bowie","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/playlist\/search\/{term}":{"get":{"summary":"Search playlist by name","responses":{"200":{"description":"A playlist collection response with the 20 most pertinent playlists","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistCollectionResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No song found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name or an identifier","schema":{"type":"string","default":"rap caviar","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/radio\/search\/{term}":{"get":{"summary":"Search radio by name","responses":{"200":{"description":"A radio collection response with the 20 most pertinent radio","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RadioCollectionResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No Radio found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name","schema":{"type":"string","default":"bbc","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/festival\/search\/{term}":{"get":{"summary":"Search festival by name","responses":{"200":{"description":"A song collection response with the 20 most pertinent songs","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FestivalCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No festival found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name","schema":{"type":"string","default":"coachella","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/venue\/search\/{term}":{"get":{"summary":"Search venue by name","responses":{"200":{"description":"A song collection response with the 20 most pertinent songs","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VenueCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No venue found for this term"}},"tags":["Search"],"parameters":[{"name":"term","in":"path","required":true,"description":"A name","schema":{"type":"string","default":"the o2","pattern":".+"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 20)","schema":{"type":"integer","default":20,"minimum":1,"maximum":20}}]}},"\/api\/v2\/search\/external\/url":{"get":{"summary":"Get Soundcharts URL from platform URL","responses":{"200":{"description":"Get Soundcharts URL using a platform URL","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ResolveExternalUrlResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"No Soundcharts url found for this platform url"}},"tags":["Search"],"parameters":[{"name":"platformUrl","in":"query","required":true,"description":"Url platform encoded","schema":{"type":"string","default":"https:\/\/open.spotify.com\/artist\/6qqNVTkY8uBg9cP3Jd7DAH"}}]}},"\/api\/v2\/top\/songs":{"post":{"summary":"Get songs (premium)","responses":{"200":{"description":"Top Song collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopSongCollectionResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Song"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"streams","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"spotify","type":"string"},"metricType":{"example":"streams","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 500)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/song\/{uuid}":{"get":{"summary":"Get song metadata","responses":{"200":{"description":"A Song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.8\/song\/{uuid}":{"get":{"summary":"Get song metadata","responses":{"200":{"description":"A Song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2.25\/song\/{uuid}":{"get":{"summary":"Get song metadata","responses":{"200":{"description":"A Song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/song\/by-isrc\/{isrc}":{"get":{"summary":"Get song by ISRC","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"isrc","in":"path","required":true,"description":"An ISRC code","schema":{"type":"string","default":"USAT22003425"}}]}},"\/api\/v2.8\/song\/by-isrc\/{isrc}":{"get":{"summary":"Get song by ISRC","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"isrc","in":"path","required":true,"description":"An ISRC code","schema":{"type":"string","default":"USAT22003425"}}]}},"\/api\/v2.25\/song\/by-isrc\/{isrc}":{"get":{"summary":"Get song by ISRC","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse3"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"isrc","in":"path","required":true,"description":"An ISRC code","schema":{"type":"string","default":"USAT22003425"}}]}},"\/api\/v2\/song\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get song by platform ID","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A song platform Identifier.","schema":{"type":"string","default":"7A9rdAz2M6AjRwOa34jxIP"}}]}},"\/api\/v2.8\/song\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get song by platform ID","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A song platform Identifier.","schema":{"type":"string","default":"7A9rdAz2M6AjRwOa34jxIP"}}]}},"\/api\/v2.25\/song\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get song by platform ID","responses":{"200":{"description":"A song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse3"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"410":{"description":"ISRC Blacklisted due to multiple tracks identified from DSP"}},"tags":["Song"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"identifier","in":"path","required":true,"description":"A song platform Identifier.","schema":{"type":"string","default":"7A9rdAz2M6AjRwOa34jxIP"}}]}},"\/api\/v2\/song\/{uuid}\/lyrics-analysis":{"get":{"summary":"Get lyrics analysis","responses":{"200":{"description":"A Lyrics analysis response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LyricsAnalysisResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/song\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongIdentifierCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"onlyDefault","in":"query","allowEmptyValue":true,"description":"Get only default identifier by platform","schema":{"type":"boolean","default":false}}]}},"\/api\/v2\/song\/{uuid}\/albums":{"get":{"summary":"Get albums","responses":{"200":{"description":"An song album collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AlbumCollectionResponse5"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"type","in":"query","description":"Filter result album list. Available values are :all, album, single, compil","schema":{"type":"string","default":"all"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : title, releaseDate","schema":{"type":"string","default":"title"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/song\/{uuid}\/audience\/{platform}":{"get":{"summary":"Get audience","responses":{"200":{"description":"A song response with platform stream for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"identifier","in":"query","required":false,"description":"Optional song identifier (example : 2Fxmhks0bxGSBdJ92vM42m)","schema":{"type":"string","default":""}}]}},"\/api\/v2\/song\/{uuid}\/spotify\/stream":{"get":{"summary":"Get Spotify streams (deprecated)","responses":{"200":{"description":"A song response with Spotify stream for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2.24\/song\/{uuid}\/spotify\/stream":{"get":{"summary":"Get Spotify streams (deprecated)","responses":{"200":{"description":"A song response with Spotify stream for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2\/song\/{uuid}\/youtube\/views":{"get":{"summary":"Get YouTube views (deprecated)","responses":{"200":{"description":"A song response with YouTube views for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/YoutubeViewsPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2\/song\/{uuid}\/youtube\/views\/video\/{identifier}":{"get":{"summary":"Get YouTube views by ID (deprecated)","responses":{"200":{"description":"A song response with YouTube views by video id for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"identifier","in":"path","required":true,"description":"A YouTube videoID.","schema":{"type":"string","default":"DyDfgMOUjCI"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2\/song\/{uuid}\/shazam\/count":{"get":{"summary":"Get Shazam count (deprecated)","responses":{"200":{"description":"A song response with shazam count for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2.24\/song\/{uuid}\/shazam\/count":{"get":{"summary":"Get Shazam count (deprecated)","responses":{"200":{"description":"A song response with shazam count for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2\/song\/{uuid}\/popularity\/{platform}":{"get":{"summary":"Get popularity","responses":{"200":{"description":"A song response popularity for a period","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongPlotCollectionResponse2"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"spotify"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2021-07-01"}}]}},"\/api\/v2\/song\/{uuid}\/charts\/ranks\/{platform}":{"get":{"summary":"Get chart entries","responses":{"200":{"description":"A song rank collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RankCollectionResponse3"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A song chart platform code","schema":{"type":"string","default":"deezer"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in charts with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, rankDate","schema":{"type":"string","default":"position"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"asc"}}]}},"\/api\/v2\/song\/{uuid}\/playlist\/current\/{platform}":{"get":{"summary":"Get playlist entries","responses":{"200":{"description":"A song playlist position collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PositionCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A playlist type. Available values are : 'all' or one of editorial, algorithmic, algotorial, major, charts, curators_listeners, radios, this_is","schema":{"type":"string","default":"all"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in playlist with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, positionDate, entryDate, subscriberCount","schema":{"type":"string","default":"entryDate"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"desc"}}]}},"\/api\/v2.20\/song\/{uuid}\/playlist\/current\/{platform}":{"get":{"summary":"Get playlist entries","responses":{"200":{"description":"A song playlist position collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PositionCollectionResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"A playlist type. Available values are : 'all' or one of editorial, algorithmic, algotorial, major, charts, curators_listeners, radios, this_is","schema":{"type":"string","default":"all"}},{"name":"currentOnly","in":"query","description":"Get only the current positions in playlist with 1, or the current and past positions with 0.","schema":{"type":"integer","default":1}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"playlistUuids","in":"query","allowEmptyValue":true,"description":"Playlist UUID separed with comma. Example : f31dc337-b8b6-43d5-bd44-527b80e1d56a,1ac5da74-64c3-4266-92a8-60bbb589a01d","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}},{"name":"sortBy","in":"query","description":"Sort criteria. Available values are : position, positionDate, entryDate, subscriberCount","schema":{"type":"string","default":"entryDate"}},{"name":"sortOrder","in":"query","description":"Sort order. Available values are : asc, desc","schema":{"type":"string","default":"desc"}}]}},"\/api\/v2\/song\/{uuid}\/playlist\/reach\/{platform}":{"get":{"summary":"Get playlist reach","responses":{"200":{"description":"A Playlist Reach Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PlaylistReachCollectionResponse2"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"path","required":true,"description":"A playlist platform code","schema":{"type":"string","default":"spotify"}},{"name":"type","in":"query","allowEmptyValue":true,"required":false,"description":"Available values are : 'all' or one of editorial, user, algorithmic","schema":{"type":"string","default":"all"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2025-05-25"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/song\/{uuid}\/broadcasts":{"get":{"summary":"Get radio spins","responses":{"200":{"description":"A Broadcast Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BroadcastCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"radioSlugs","in":"query","description":"Radio slugs separed with comma. Example : radio-1,radio-2,radio-3","schema":{"type":"string","default":"bbc-2,bbc-london"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Period start date (Format ATOM). Example : 2019-01-01T00:00:00Z. If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"Period end date. You can leave this field empty to get last broadcasts. Example : 2019-01-01T00:00:00Z","schema":{"type":"string"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/song\/{uuid}\/broadcast-groups":{"get":{"summary":"Get radio spin count","responses":{"200":{"description":"A Broadcast Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BroadcastCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"}},"tags":["Song"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"radioSlugs","in":"query","allowEmptyValue":true,"description":"Radio slugs separed with comma. Example : radio-1,radio-2,radio-3","schema":{"type":"string","default":"bbc-2,bbc-london"}},{"name":"countryCode","in":"query","allowEmptyValue":true,"description":"Country code (2 letters ISO 3166-2, example: 'US', full list on https:\/\/en.wikipedia.org\/wiki\/ISO_3166-2)","schema":{"type":"string"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD). If not provided, the start date defaults to 30 days before the end date.","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":"2020-10-10"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/song\/{uuid}\/sources\/add":{"post":{"summary":"Add links","responses":{"200":{"description":"An Song response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Song not found"},"405":{"description":"Sandbox only. This operation is not allowed on sandbox environment"}},"tags":["Song"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"urls":{"items":{"example":"https:\/\/open.spotify.com\/track\/2Fxmhks0bxGSBdJ92vM42m","type":"string"},"type":"array"}},"type":"object"}}}},"parameters":[{"name":"uuid","in":"path","required":true,"description":"A song UUID","schema":{"type":"string","default":"7d534228-5165-11e9-9375-549f35161576","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/tiktok\/music\/{identifier}":{"get":{"summary":"Get music","responses":{"200":{"description":"A Music response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MusicResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Music not found"}},"tags":["TikTok"],"parameters":[{"name":"identifier","in":"path","required":true,"description":"A music identifier","schema":{"type":"string","default":"6955510506778020614","pattern":"\\d+"}}]}},"\/api\/v2\/tiktok\/music\/{identifier}\/video\/volume":{"get":{"summary":"Get music video count","responses":{"200":{"description":"A music videos volume plots collection","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VideoVolumePlotCollectionResponse"}}}},"400":{"description":"Invalid period"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Music not found"}},"tags":["TikTok"],"parameters":[{"name":"identifier","in":"path","required":true,"description":"A music identifier","schema":{"type":"string","default":"6955510506778020614","pattern":"[0-9]+"}},{"name":"endDate","in":"query","required":false,"description":"Optional period filter (YYYY-MM-DD format)","schema":{"type":"string","default":"2021-05-04","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"period","in":"query","required":false,"description":"Number of historical days","schema":{"type":"integer","default":"30"}}]}},"\/api\/v2\/user\/{email}\/blocklist\/artists":{"get":{"summary":"Get blocklists artists","responses":{"200":{"description":"A Blocklist Artist Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ArtistCollectionResponse2"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"User not found in the team"}},"tags":["User"],"parameters":[{"name":"email","in":"path","required":true,"description":"url encoded email","schema":{"type":"string","default":"api-sandbox@soundcharts.com","pattern":"^[a-zA-Z0-9.!#$%&\\'*+\\\\\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/user\/{email}\/blocklist\/songs":{"get":{"summary":"Get blocklists songs","responses":{"200":{"description":"A Blocklist Song Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SongCollectionResponse4"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"User not found in the team"}},"tags":["User"],"parameters":[{"name":"email","in":"path","required":true,"description":"url_encoded email","schema":{"type":"string","default":"api-sandbox@soundcharts.com","pattern":"^[a-zA-Z0-9.!#$%&\\'*+\\\\\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/user\/{email}\/blocklist\/labels":{"get":{"summary":"Get blocklists labels","responses":{"200":{"description":"A Blocklist Label Collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LabelCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"User not found in the team"}},"tags":["User"],"parameters":[{"name":"email","in":"path","required":true,"description":"url_encoded email","schema":{"type":"string","default":"api-sandbox@soundcharts.com","pattern":"^[a-zA-Z0-9.!#$%&\\'*+\\\\\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)+$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/top\/venues":{"post":{"summary":"Get venues (premium)","responses":{"200":{"description":"Top venue collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TopVenueCollectionResponse"}}}},"400":{"description":"Invalid request"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."}},"tags":["Venue"],"requestBody":{"content":{"application\/json":{"schema":{"properties":{"sort":{"properties":{"platform":{"example":"x","type":"string"},"metricType":{"example":"followers","type":"string"},"period":{"example":"month","type":"string"},"sortBy":{"example":"total","type":"string"},"order":{"example":"desc","type":"string"}},"type":"object"},"filters":{"items":{"properties":{"type":{"example":"metric","type":"string"},"data":{"properties":{"platform":{"example":"x","type":"string"},"metricType":{"example":"followers","type":"string"},"min":{"example":"0","type":"number"},"max":{"example":"100000","type":"number"}},"type":"object"}},"type":"object"},"type":"array","maxItems":100}},"type":"object"}}}},"parameters":[{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 500)","schema":{"type":"integer","default":100,"minimum":1,"maximum":500}}]}},"\/api\/v2\/venue\/{uuid}":{"get":{"summary":"Get venue metadata","responses":{"200":{"description":"A venue response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VenueResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Venue"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A venue UUID","schema":{"type":"string","default":"a8941d07-3cb4-4601-a362-9c856b4be4c8","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/venue\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get venue by platform ID","responses":{"200":{"description":"A venue response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VenueResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Venue"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"instagram"}},{"name":"identifier","in":"path","required":true,"description":"A venue platform identifier","schema":{"type":"string","default":"thegarden"}}]}},"\/api\/v2\/venue\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VenueIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Venue"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A venue UUID","schema":{"type":"string","default":"a8941d07-3cb4-4601-a362-9c856b4be4c8","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/venue\/{uuid}\/concerts":{"get":{"summary":"Get concerts","responses":{"200":{"description":"An event collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/VenueEventCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Venue"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A venue UUID","schema":{"type":"string","default":"a8941d07-3cb4-4601-a362-9c856b4be4c8","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"startDate","in":"query","allowEmptyValue":true,"description":"Optional period start date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"endDate","in":"query","allowEmptyValue":true,"description":"Optional period end date (format YYYY-MM-DD)","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/venue\/concert\/{uuid}":{"get":{"summary":"Get concert details","responses":{"200":{"description":"An event response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EventResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Venue not found"}},"tags":["Venue"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A concert UUID","schema":{"type":"string","default":"bf948ce4-9644-44ac-b81f-09f9ca443f0b","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/work\/{uuid}":{"get":{"summary":"Get work metadata","responses":{"200":{"description":"A Work response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WorkResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Work not found"}},"tags":["Work"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Work UUID","schema":{"type":"string","default":"4de82680-b832-4875-a9d7-3ef503aafe2d","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}}]}},"\/api\/v2\/work\/by-iswc\/{iswc}":{"get":{"summary":"Get work by ISWC","responses":{"200":{"description":"A work response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WorkResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Work not found"}},"tags":["Work"],"parameters":[{"name":"iswc","in":"path","required":true,"description":"A Work ISWC","schema":{"type":"string","default":"T9280410915"}}]}},"\/api\/v2\/work\/by-platform\/{platform}\/{identifier}":{"get":{"summary":"Get work by platform ID","responses":{"200":{"description":"A work response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WorkResponse"}}}},"400":{"description":"Invalid platform code"},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Work not found"}},"tags":["Work"],"parameters":[{"name":"platform","in":"path","required":true,"description":"A platform code","schema":{"type":"string","default":"mlc"}},{"name":"identifier","in":"path","required":true,"description":"A Work platform Identifier.","schema":{"type":"string","default":"856534330"}}]}},"\/api\/v2\/work\/{uuid}\/identifiers":{"get":{"summary":"Get IDs","responses":{"200":{"description":"An Identifier collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WorkIdentifierCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Work not found"}},"tags":["Work"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Work UUID","schema":{"type":"string","default":"4de82680-b832-4875-a9d7-3ef503aafe2d","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"platform","in":"query","description":"A platform code","schema":{"type":"string","default":""}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/work\/{uuid}\/recordings":{"get":{"summary":"Get recordings","responses":{"200":{"description":"A Song collection response","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WorkSongCollectionResponse"}}}},"401":{"description":"You are not logged in"},"403":{"description":"This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access."},"404":{"description":"Work not found"}},"tags":["Work"],"parameters":[{"name":"uuid","in":"path","required":true,"description":"A Work UUID","schema":{"type":"string","default":"4de82680-b832-4875-a9d7-3ef503aafe2d","pattern":"^\\w{8}-\\w{4}-\\w{4}-\\w{4}-\\w{12}$"}},{"name":"offset","in":"query","description":"Get results starting from position","schema":{"type":"integer","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Number of results (max. 100)","schema":{"type":"integer","default":100,"minimum":1,"maximum":100}}]}},"\/api\/v2\/swagger.json":{"get":{"responses":{"default":{"description":""}}}},"\/api\/v2\/doc":{"get":{"responses":{"default":{"description":""}}}}},"components":{"schemas":{"AlbumResponse":{"title":"Album","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Album"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumResponse2":{"title":"Album","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Album2"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumResponse3":{"title":"Album","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Album3"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumResponse4":{"title":"Album","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Album4"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumIdentifierCollectionResponse":{"title":"Album Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/AlbumLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumTrackCollectionResponse":{"title":"Album Track Collection","properties":{"related":{"$ref":"#\/components\/schemas\/AlbumLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumTrack"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumPlotCollectionResponse":{"title":"Album Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/AlbumLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AudiencePlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RankCollectionResponse":{"title":"Album Rank Collection","properties":{"related":{"$ref":"#\/components\/schemas\/AlbumLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Rank"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopArtistCollectionResponse":{"title":"Top Artist Collection","properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricArtist"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistResponse":{"title":"Artist","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Artist"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistResponse2":{"title":"Artist","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Artist2"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistIdentifierCollectionResponse":{"title":"Artist Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/SongLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongCollectionResponse2":{"properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumCollectionResponse":{"title":"Album Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumLight2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumCollectionResponse2":{"title":"Album Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumLightReleaseDate"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumCollectionResponse3":{"title":"Album Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumCollectionResponse4":{"title":"Album Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/TypedAlbumLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistCollectionResponse":{"title":"Artist Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/ArtistSearch"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"CurrentStatsResponse":{"properties":{"related":{"items":{"$ref":"#\/components\/schemas\/ArtistLightStat"},"type":"array"},"social":{"items":{"$ref":"#\/components\/schemas\/StatPlot"},"type":"array"},"streaming":{"items":{"$ref":"#\/components\/schemas\/StatPlot"},"type":"array"},"popularity":{"items":{"$ref":"#\/components\/schemas\/StatPlot"},"type":"array"},"retention":{"items":{"$ref":"#\/components\/schemas\/StatPlot"},"type":"array"},"score":{"items":{"$ref":"#\/components\/schemas\/StatPlot"},"type":"array"}},"type":"object"},"SoundchartsScoreCollectionResponse":{"properties":{"related":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"items":{"items":{"$ref":"#\/components\/schemas\/Score"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudiencePlotCollectionResponse":{"title":"Social Audience Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SocialAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/AudiencePlot2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SocialPlotCollectionResponse":{"title":"Social Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SocialAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/SocialPlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"GlobalAudiencePlotCollectionResponse":{"title":"Global Audience Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SocialAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"StreamingPlotCollectionResponse":{"title":"Streaming Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SocialAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/StreamingPlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RetentionPlotCollectionResponse":{"title":"Retention Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/StreamingAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/RetentionPlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PopularityPlotCollectionResponse":{"title":"Popularity Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/StreamingAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudienceReportResponse":{"title":"Audience Report","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Report"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudienceReportDateCollectionResponse":{"title":"Audience report date Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SocialAccount"},"items":{"type":"string","format":"date-time"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SocialVideoCollectionResponse":{"title":"Social Video Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight2"},"items":{"items":{"$ref":"#\/components\/schemas\/SocialVideo"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudienceCollectionResponse":{"title":"ShortVideo Audience Collection","properties":{"related":{"$ref":"#\/components\/schemas\/AudienceArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Audience"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RankCollectionResponse2":{"title":"Artist Chart Ranks","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Rank2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumRankCollectionResponse":{"title":"Artist Chart Album Ranks","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumRank"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumRankCollectionResponse2":{"title":"Artist Chart Album Ranks","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumRank2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TrackCollectionResponse":{"title":"Artist Playlist Track Positions","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Track"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TrackCollectionResponse2":{"title":"Artist Playlist Track Positions","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Track2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistReachCollectionResponse":{"title":"Artist Playlist Reachs","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Reach"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"BroadcastCollectionResponse":{"title":"Broadcast Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Broadcast"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"EventCollectionResponse":{"title":"Event Collection","properties":{"related":{"$ref":"#\/components\/schemas\/EventAccount"},"items":{"items":{"$ref":"#\/components\/schemas\/Event"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistEventCollectionResponse":{"title":"Artist Event Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/ArtistEvent"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ContactCollectionResponse":{"title":"Contact Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ArtistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Contact"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopSongCollectionResponse":{"title":"Song Collection","properties":{"related":{"items":{"$ref":"#\/components\/schemas\/TopRelated"},"type":"array"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricSong"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopBroadcastCollectionResponse":{"title":"Broadcast Collection","properties":{"related":{"items":{"$ref":"#\/components\/schemas\/TopRelated"},"type":"array"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricBroadcast"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ChartCollectionResponse":{"title":"Chart Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/ChartLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ChartSongRankCollectionResponse":{"title":"Song Chart Rank Collection","properties":{"related":{"$ref":"#\/components\/schemas\/Ranking"},"items":{"items":{"$ref":"#\/components\/schemas\/SongRank"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ChartSongRankCollectionResponse2":{"title":"Song Chart Rank Collection","properties":{"related":{"$ref":"#\/components\/schemas\/Ranking2"},"items":{"items":{"$ref":"#\/components\/schemas\/SongRank2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AvailableRankingCollectionResponse":{"title":"Chart Ranking Dates Collection","properties":{"related":{"$ref":"#\/components\/schemas\/ChartLight"},"items":{"items":{"type":"string","format":"date-time"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ChartAlbumRankCollectionResponse":{"title":"Album Chart Rank Collection","properties":{"related":{"$ref":"#\/components\/schemas\/Ranking"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumRank3"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ChartAlbumRankCollectionResponse2":{"properties":{"related":{"$ref":"#\/components\/schemas\/Ranking"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumRank4"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TiktokMusicRankCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/TiktokRanking"},"items":{"items":{"$ref":"#\/components\/schemas\/TiktokMusicRank"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AvailableTiktokMusicRankingCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/TiktokChart"},"items":{"items":{"type":"string","format":"date-time"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"CollaboratorResponse":{"title":"Collaborator Response","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Collaborator"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"CollaboratorIdentifierCollectionResponse":{"title":"Collaborator Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/CollaboratorLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopFestivalCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricFestival"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"FestivalResponse":{"title":"Festival","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Festival"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"FestivalIdentifierCollectionResponse":{"title":"Festival Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/FestivalLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"EditionCollectionResponse":{"title":"Festival Event Collection","properties":{"related":{"$ref":"#\/components\/schemas\/FestivalLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Edition"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"EditionResponse":{"title":"Edition","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Edition"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistIdentifierCollectionResponse2":{"title":"ArtistIdentifier Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/ArtistIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"IdentifiersSubmittedResponse":{"title":"Identifiers Response","properties":{"sent":{"type":"integer"},"updated":{"type":"integer"},"duplicate":{"type":"integer"},"ignored":{"type":"integer"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongIdentifierCollectionResponse":{"title":"SongIdentifier Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/SongIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopPlaylistCollectionResponse":{"title":"Top Playlist Collection","properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricPlaylist"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistResponse":{"title":"Playlist","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Playlist"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistResponse2":{"title":"Playlist","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Playlist2"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"OwnerCollectionResponse":{"title":"Playlist Owner Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Owner"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistCollectionResponse":{"title":"Playlist Collection","properties":{"related":{"$ref":"#\/components\/schemas\/Owner"},"items":{"items":{"$ref":"#\/components\/schemas\/PlaylistLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistCollectionResponse2":{"title":"Playlist Collection","properties":{"related":{"$ref":"#\/components\/schemas\/Owner"},"items":{"items":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistCollectionResponse3":{"title":"Playlist By Type Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/PlaylistLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudiencePlotCollectionResponse2":{"title":"Audience Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/PlaylistLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AudiencePlotCollectionResponse3":{"title":"Audience Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistCollectionResponse4":{"title":"Playlist Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TrackCollectionResponse3":{"title":"Playlist Track Collection","properties":{"related":{"$ref":"#\/components\/schemas\/TrackListing"},"items":{"items":{"$ref":"#\/components\/schemas\/Track3"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TrackCollectionResponse4":{"title":"Playlist Track Collection","properties":{"related":{"$ref":"#\/components\/schemas\/TrackListing2"},"items":{"items":{"$ref":"#\/components\/schemas\/Track3"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TracklistingDateCollectionResponse":{"title":"Playlist Tracklisting date Collection","properties":{"related":{"$ref":"#\/components\/schemas\/PlaylistLight"},"items":{"items":{"type":"string","format":"date-time"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TracklistingDateCollectionResponse2":{"title":"Playlist Tracklisting date Collection","properties":{"related":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"items":{"items":{"type":"string","format":"date-time"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PublisherResponse":{"title":"Publisher","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Publisher"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PublisherIdentifierCollectionResponse":{"title":"Publisher Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/PublisherLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopRadioCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricRadio"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RadioCollectionResponse":{"title":"Radio Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/RadioLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RadioCollectionResponse2":{"title":"Radio Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Radio"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RadioCollectionResponse3":{"title":"Radio Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/RadioLight2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"LiveFeedCollectionResponse":{"title":"Live feed Collection","properties":{"related":{"$ref":"#\/components\/schemas\/RadioLight"},"items":{"items":{"$ref":"#\/components\/schemas\/SongBroadcast"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RadioIdentifierCollectionResponse":{"title":"Radio Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/RadioLight2"},"items":{"items":{"$ref":"#\/components\/schemas\/Identifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlatformCollectionResponse":{"title":"Platform Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Platform"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"CountryCollectionResponse":{"title":"Country Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Country"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"GenreCollectionResponse":{"title":"Genre Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Genre"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"CityCollectionResponse":{"title":"City Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/City"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"LabelTypesResponse":{"title":"Label Types Response","properties":{"type":{"type":"string"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"},"labelTypes":{"items":{"type":"string"},"type":"array"}},"type":"object"},"DistributorCollectionResponse":{"title":"Distributor Collection Response","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Distributor"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"LyricsAttributesCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/Attribute"},"items":{"items":{"$ref":"#\/components\/schemas\/LyricsAttribute"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongCollectionResponse3":{"title":"Song Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"FestivalCollectionResponse":{"title":"Festival Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/VenueLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"VenueCollectionResponse":{"title":"Venue Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/VenueLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ResolveExternalUrlResponse":{"properties":{"type":{"type":"string"},"url":{"type":"string"},"uuid":{"type":"string"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopSongCollectionResponse2":{"title":"Top Song Collection","properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricSong2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongResponse":{"title":"Song","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Song"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongResponse2":{"title":"Song","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Song2"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongResponse3":{"title":"Song","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Song3"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"LyricsAnalysisResponse":{"properties":{"related":{"items":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"type":"array"},"lyricsAnalysis":{"$ref":"#\/components\/schemas\/LyricsAnalysis"}},"type":"object"},"SongIdentifierCollectionResponse2":{"title":"Song Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"AlbumCollectionResponse5":{"title":"Album Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"items":{"items":{"$ref":"#\/components\/schemas\/AlbumLightDefault"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongPlotCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/AudiencePlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongPlotCollectionResponse2":{"title":"Song Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"YoutubeViewsPlotCollectionResponse":{"title":"YouTube Views Plot Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/SongVideoPlot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"RankCollectionResponse3":{"title":"Song Rank Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Rank3"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PositionCollectionResponse":{"title":"Playlist Position Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Position"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PositionCollectionResponse2":{"title":"Playlist Position Collection","properties":{"related":{"$ref":"#\/components\/schemas\/SongLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Position2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"PlaylistReachCollectionResponse2":{"title":"Song Playlist Reachs","properties":{"related":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"items":{"items":{"$ref":"#\/components\/schemas\/Reach"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"MusicResponse":{"properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/MusicFull"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"VideoVolumePlotCollectionResponse":{"title":"Video volume plot collection","properties":{"related":{"$ref":"#\/components\/schemas\/Music"},"items":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"ArtistCollectionResponse2":{"title":"Blocklist Artist Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"SongCollectionResponse4":{"title":"Blocklist Song Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/SongLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"LabelCollectionResponse":{"title":"Blocklist Label Collection","properties":{"items":{"items":{"$ref":"#\/components\/schemas\/Label"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"TopVenueCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/TopRelated"},"items":{"items":{"$ref":"#\/components\/schemas\/MetricVenue"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"VenueResponse":{"title":"Venue","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Venue"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"VenueIdentifierCollectionResponse":{"title":"Venue Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/VenueLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"VenueEventCollectionResponse":{"title":"Venue Event Collection","properties":{"related":{"$ref":"#\/components\/schemas\/VenueLight"},"items":{"items":{"$ref":"#\/components\/schemas\/Event2"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"EventResponse":{"title":"Event","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Event2"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"WorkResponse":{"title":"Work","properties":{"type":{"type":"string"},"object":{"$ref":"#\/components\/schemas\/Work"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"WorkIdentifierCollectionResponse":{"title":"Work Identifier Collection","properties":{"related":{"$ref":"#\/components\/schemas\/WorkLight"},"items":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"WorkSongCollectionResponse":{"properties":{"related":{"$ref":"#\/components\/schemas\/WorkLight"},"items":{"items":{"$ref":"#\/components\/schemas\/SongLight"},"type":"array"},"page":{"$ref":"#\/components\/schemas\/OffsetPage"},"errors":{"items":{"$ref":"#\/components\/schemas\/Error"},"type":"array"}},"type":"object"},"Album":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"upc":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"label":{"type":"string"},"totalTracks":{"type":"integer"},"copyright":{"type":"string"},"distributor":{"type":"string"},"imageUrl":{"type":"string"},"uuid":{"type":"string"}},"type":"object"},"Error":{"title":"Error","properties":{"key":{"description":"Error key","type":"string"},"code":{"description":"Error code","type":"integer"},"message":{"description":"Error message","type":"string"}},"type":"object"},"Album2":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"upc":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"totalTracks":{"type":"integer"},"copyright":{"type":"string"},"distributor":{"type":"string"},"imageUrl":{"type":"string"},"uuid":{"type":"string"},"labels":{"items":{"$ref":"#\/components\/schemas\/Label2"},"type":"array"},"type":{"type":"string"}},"type":"object"},"Album3":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"slug":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"upc":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"label":{"type":"string"},"totalTracks":{"type":"integer"},"copyright":{"type":"string"},"distributor":{"type":"string"}},"type":"object"},"Album4":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"slug":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"upc":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"label":{"type":"string"},"totalTracks":{"type":"integer"},"copyright":{"type":"string"},"distributor":{"type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"AlbumLight":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"uuid":{"type":"string"}},"type":"object"},"PlatformIdentifier":{"properties":{"platformName":{"type":"string"},"platformCode":{"type":"string"},"identifier":{"type":"string"},"url":{"type":"string"},"default":{"type":"boolean"}},"type":"object"},"OffsetPage":{"title":"Offset Page","properties":{"offset":{"description":"The offset of the items returned (as set in the request or by default). Default is 0","type":"integer"},"limit":{"description":"The maximum number of items in the response (as set in the request or by default).","type":"integer"},"next":{"description":"URL to the next page of items. (null if none)","type":"string"},"previous":{"description":"URL to the previous page of items. (null if none)","type":"string"},"total":{"description":"The maximum number of items available to return.","type":"integer"}},"type":"object"},"AlbumTrack":{"properties":{"discNumber":{"type":"integer"},"number":{"type":"integer"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"AudiencePlot":{"properties":{"date":{"type":"string","format":"date-time"},"plots":{"items":{"$ref":"#\/components\/schemas\/Plot2"},"type":"array"}},"type":"object"},"Rank":{"title":"Album Chart Rank","properties":{"chart":{"$ref":"#\/components\/schemas\/Chart"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"peakDate":{"type":"string","format":"date-time"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"current":{"type":"boolean"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"TopRelated":{"properties":{"updatedAt":{"type":"string","format":"date-time"}},"type":"object"},"MetricArtist":{"properties":{"artist":{"$ref":"#\/components\/schemas\/ArtistLight"},"social":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"streaming":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"popularity":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"custom":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialView":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialLike":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialPost":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialFollowing":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"growthLevel":{"type":"string"}},"type":"object"},"Artist":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"countryCode":{"type":"string"},"webUrl":{"type":"string"}},"type":"object"},"Artist2":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"countryCode":{"type":"string"},"webUrl":{"type":"string"},"genres":{"items":{"type":"string"},"type":"array"},"biography":{"type":"string"},"isni":{"type":"string"},"ipi":{"type":"string"},"gender":{"type":"string"},"type":{"type":"string"},"birthDate":{"type":"string","format":"date-time"},"careerStage":{"type":"string"},"growthLevel":{"type":"string"},"cityName":{"type":"string"}},"type":"object"},"ArtistLight":{"title":"Artist Light","properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"SongLight":{"title":"Song Light","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"creditName":{"type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"SongLightReleaseDate":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"creditName":{"type":"string"},"imageUrl":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"}},"type":"object"},"AlbumLight2":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"AlbumLightReleaseDate":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"slug":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"}},"type":"object"},"TypedAlbumLight":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"uuid":{"type":"string"},"type":{"type":"string"}},"type":"object"},"ArtistSearch":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"countryCode":{"type":"string"},"webUrl":{"type":"string"},"genres":{"items":{"type":"string"},"type":"array"},"isni":{"type":"string"},"careerStage":{"type":"string"},"growthLevel":{"type":"string"}},"type":"object"},"ArtistLightStat":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"period":{"type":"integer"}},"type":"object"},"StatPlot":{"properties":{"platform":{"type":"string"},"value":{"type":"number","format":"number"},"date":{"type":"string","format":"date-time"},"evolution":{"type":"integer"},"percentEvolution":{"type":"number","format":"number"}},"type":"object"},"Score":{"properties":{"date":{"type":"string","format":"date-time"},"scScore":{"type":"integer"},"fanbaseScore":{"type":"integer"},"trendingScore":{"type":"integer"}},"type":"object"},"SocialAccount":{"title":"Social Account","properties":{"artist":{"$ref":"#\/components\/schemas\/ArtistLight"},"platform":{"type":"string"},"lastCrawlDate":{"type":"string","format":"date-time"}},"type":"object"},"AudiencePlot2":{"properties":{"date":{"type":"string","format":"date-time"},"likeCount":{"type":"integer"},"followerCount":{"type":"integer"},"followingCount":{"type":"integer"},"postCount":{"type":"integer"},"viewCount":{"type":"integer"}},"type":"object"},"SocialPlot":{"properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"integer"},"cityPlots":{"items":{"$ref":"#\/components\/schemas\/CityPlot"},"type":"array"},"countryPlots":{"items":{"$ref":"#\/components\/schemas\/CountryPlot"},"type":"array"}},"type":"object"},"Plot":{"properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"integer"}},"type":"object"},"StreamingPlot":{"properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"integer"},"cityPlots":{"items":{"$ref":"#\/components\/schemas\/CityPlot"},"type":"array"},"countryPlots":{"items":{"$ref":"#\/components\/schemas\/CountryPlot"},"type":"array"}},"type":"object"},"StreamingAccount":{"title":"Streaming Account","properties":{"artist":{"$ref":"#\/components\/schemas\/ArtistLight"},"platform":{"type":"string"},"lastCrawlDate":{"type":"string","format":"date-time"}},"type":"object"},"RetentionPlot":{"properties":{"date":{"type":"string","format":"date-time"},"conversionRate":{"type":"number","format":"number"},"followers":{"type":"integer"},"listeners":{"type":"integer"}},"type":"object"},"Report":{"properties":{"top":{"$ref":"#\/components\/schemas\/Top"},"audience":{"$ref":"#\/components\/schemas\/Audience2"}},"type":"object"},"ArtistLight2":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"platform":{"type":"string"},"lastCrawlDate":{"type":"string","format":"date-time"}},"type":"object"},"SocialVideo":{"properties":{"identifier":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"externalUrl":{"type":"string"},"latestAudience":{"$ref":"#\/components\/schemas\/Audience"}},"type":"object"},"AudienceArtistLight":{"properties":{"uuid":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"identifier":{"type":"string"},"createdAt":{"title":"Used by serializer","type":"string","format":"date-time"},"latestAudience":{"$ref":"#\/components\/schemas\/Audience"}},"type":"object"},"Audience":{"properties":{"date":{"type":"string","format":"date-time"},"comments":{"type":"integer"},"views":{"type":"integer"},"likes":{"type":"integer"}},"type":"object"},"Rank2":{"properties":{"chart":{"$ref":"#\/components\/schemas\/Chart"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"current":{"type":"boolean"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"AlbumRank":{"properties":{"chart":{"$ref":"#\/components\/schemas\/Chart"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"current":{"type":"boolean"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"},"album":{"$ref":"#\/components\/schemas\/AlbumLight2"}},"type":"object"},"AlbumRank2":{"properties":{"chart":{"$ref":"#\/components\/schemas\/Chart"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"current":{"type":"boolean"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"},"album":{"$ref":"#\/components\/schemas\/AlbumLight"}},"type":"object"},"Track":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight"},"position":{"type":"integer"},"peakPosition":{"type":"integer"},"entryDate":{"type":"string","format":"date-time"},"exitDate":{"type":"string","format":"date-time"},"positionDate":{"type":"string","format":"date-time"},"peakPositionDate":{"type":"string","format":"date-time"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"Track2":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"position":{"type":"integer"},"peakPosition":{"type":"integer"},"entryDate":{"type":"string","format":"date-time"},"exitDate":{"type":"string","format":"date-time"},"positionDate":{"type":"string","format":"date-time"},"peakPositionDate":{"type":"string","format":"date-time"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"Reach":{"properties":{"date":{"type":"string","format":"date-time"},"playlistCount":{"type":"integer"},"playlistReach":{"type":"integer"}},"type":"object"},"Broadcast":{"properties":{"airedAt":{"type":"string","format":"date-time"},"duration":{"type":"integer"},"radio":{"$ref":"#\/components\/schemas\/RadioLight"}},"type":"object"},"EventAccount":{"title":"Event Account","properties":{"artist":{"$ref":"#\/components\/schemas\/ArtistLight"},"platform":{"type":"string"},"lastCrawlDate":{"type":"string","format":"date-time"}},"type":"object"},"Event":{"properties":{"name":{"type":"string"},"date":{"type":"string","format":"date-time"},"type":{"type":"string"},"venue":{"$ref":"#\/components\/schemas\/Venue2"},"url":{"type":"string"}},"type":"object"},"ArtistEvent":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"venue":{"$ref":"#\/components\/schemas\/VenueLight"},"price":{"$ref":"#\/components\/schemas\/Price"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"},"festival":{"$ref":"#\/components\/schemas\/FestivalLight"},"date":{"type":"string","format":"date-time"}},"type":"object"},"Contact":{"properties":{"type":{"type":"string"},"address":{"type":"string"}},"type":"object"},"MetricSong":{"properties":{"total":{"type":"integer"},"change":{"type":"integer"},"percent":{"type":"number","format":"number"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"MetricBroadcast":{"properties":{"total":{"type":"integer"},"change":{"type":"integer"},"percent":{"type":"number","format":"number"},"radio":{"$ref":"#\/components\/schemas\/TopRadio"}},"type":"object"},"ChartLight":{"properties":{"name":{"type":"string"},"type":{"type":"string"},"slug":{"type":"string"},"platform":{"type":"string"},"frequency":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"cityName":{"type":"string"},"maxResultsCount":{"type":"integer"},"webUrl":{"type":"string"}},"type":"object"},"Ranking":{"properties":{"chart":{"$ref":"#\/components\/schemas\/ChartLight"},"date":{"type":"string","format":"date-time"}},"type":"object"},"SongRank":{"properties":{"song":{"$ref":"#\/components\/schemas\/SongLight"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"Ranking2":{"properties":{"chart":{"$ref":"#\/components\/schemas\/ChartLight2"},"date":{"type":"string","format":"date-time"}},"type":"object"},"SongRank2":{"properties":{"song":{"$ref":"#\/components\/schemas\/SongLight"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"metric":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"AlbumRank3":{"properties":{"album":{"$ref":"#\/components\/schemas\/AlbumLight2"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"AlbumRank4":{"properties":{"album":{"$ref":"#\/components\/schemas\/AlbumLight"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"TiktokRanking":{"properties":{"chart":{"$ref":"#\/components\/schemas\/TiktokChart"},"date":{"type":"string","format":"date-time"}},"type":"object"},"TiktokMusicRank":{"properties":{"music":{"$ref":"#\/components\/schemas\/Music"},"song":{"$ref":"#\/components\/schemas\/SongLight"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"},"value":{"title":"Post evolution count","type":"integer"},"oldValue":{"title":"Old post evolution count","type":"integer"},"totalValue":{"title":"Total post count","type":"integer"},"oldTotalValue":{"title":"Old total post count","type":"integer"}},"type":"object"},"TiktokChart":{"properties":{"frequency":{"type":"string"},"type":{"type":"string"}},"type":"object"},"Collaborator":{"title":"Collaborator","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string"},"isni":{"type":"string"},"ipi":{"type":"string"},"roles":{"type":"string"},"countryCode":{"type":"string"},"webUrl":{"type":"string"},"biography":{"type":"string"},"gender":{"type":"string"},"type":{"type":"string"},"birthDate":{"type":"string","format":"date-time"},"cityName":{"type":"string"}},"type":"object"},"CollaboratorLight":{"title":"Collaborator Light","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"MetricFestival":{"properties":{"festival":{"$ref":"#\/components\/schemas\/FestivalLight"},"social":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"streaming":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"popularity":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"custom":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialView":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialLike":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialPost":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialFollowing":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"}},"type":"object"},"Festival":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"cityName":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"region":{"type":"string"},"imageUrl":{"type":"string"},"address":{"type":"string"},"zipCode":{"type":"string"},"geo":{"$ref":"#\/components\/schemas\/Coordinates"},"capacity":{"type":"string"},"website":{"type":"string"},"venue":{"items":{"$ref":"#\/components\/schemas\/VenueLight"},"type":"array"}},"type":"object"},"FestivalLight":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"cityName":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"region":{"type":"string"},"imageUrl":{"type":"string"},"type":{"type":"string"}},"type":"object"},"Edition":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"venue":{"$ref":"#\/components\/schemas\/VenueLight"},"price":{"$ref":"#\/components\/schemas\/Price"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"},"festival":{"$ref":"#\/components\/schemas\/FestivalLight"},"artists":{"items":{"$ref":"#\/components\/schemas\/Artist3"},"type":"array"},"identifiers":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier2"},"type":"array"},"ticketUrls":{"items":{"type":"string"},"type":"array"}},"type":"object"},"ArtistIdentifier":{"properties":{"platformCode":{"type":"string"},"identifier":{"type":"string"},"artist":{"$ref":"#\/components\/schemas\/ArtistLight"}},"type":"object"},"SongIdentifier":{"properties":{"platformCode":{"type":"string"},"identifier":{"type":"string"},"song":{"$ref":"#\/components\/schemas\/SongLight"}},"type":"object"},"MetricPlaylist":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/TopPlaylistLight"},"audience":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"}},"type":"object"},"Playlist":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"identifier":{"type":"string"},"platform":{"type":"string"},"countryCode":{"type":"string"},"owner":{"$ref":"#\/components\/schemas\/Owner"},"latestCrawlDate":{"type":"string","format":"date-time"},"latestTrackCount":{"type":"integer"},"latestSubscriberCount":{"type":"integer"},"type":{"type":"string"},"refreshed":{"title":"Refreshed frequence (multiple, daily, weekly)","type":"string"},"availableCountryCodes":{"items":{"type":"string"},"type":"array"},"genres":{"items":{"type":"string"},"type":"array"},"trackAge":{"type":"string"},"trackAddedPercent":{"type":"number","format":"number"}},"type":"object"},"Playlist2":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"identifier":{"type":"string"},"platform":{"type":"string"},"countryCode":{"type":"string"},"owner":{"$ref":"#\/components\/schemas\/Owner"},"latestCrawlDate":{"type":"string","format":"date-time"},"latestTrackCount":{"type":"integer"},"latestSubscriberCount":{"type":"integer"},"type":{"type":"string"},"refreshed":{"type":"string"},"availableCountryCodes":{"items":{"type":"string"},"type":"array"},"genres":{"items":{"type":"string"},"type":"array"},"trackAge":{"type":"string"},"trackAddedPercent":{"type":"number","format":"number"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"Owner":{"properties":{"name":{"type":"string"},"identifier":{"type":"string"}},"type":"object"},"PlaylistLight":{"title":"Playlist Light","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"identifier":{"type":"string"},"platform":{"type":"string"},"countryCode":{"type":"string"},"latestCrawlDate":{"type":"string","format":"date-time"},"latestTrackCount":{"type":"integer"},"latestSubscriberCount":{"type":"integer"},"imageUrl":{"type":"string"}},"type":"object"},"PlaylistLight2":{"title":"Playlist Light","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"identifier":{"type":"string"},"platform":{"type":"string"},"countryCode":{"type":"string"},"latestCrawlDate":{"type":"string","format":"date-time"},"latestTrackCount":{"type":"integer"},"latestSubscriberCount":{"type":"integer"},"imageUrl":{"type":"string"},"type":{"type":"string"}},"type":"object"},"TrackListing":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight"},"date":{"type":"string","format":"date-time"}},"type":"object"},"Track3":{"properties":{"position":{"type":"integer"},"song":{"$ref":"#\/components\/schemas\/SongLight"},"entryDate":{"type":"string","format":"date-time"},"exitDate":{"type":"string","format":"date-time"}},"type":"object"},"TrackListing2":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"date":{"type":"string","format":"date-time"}},"type":"object"},"Publisher":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"ipi":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"website":{"type":"string"},"address":{"type":"string"}},"type":"object"},"PublisherLight":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"}},"type":"object"},"MetricRadio":{"properties":{"radio":{"$ref":"#\/components\/schemas\/TopRadio"},"social":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"custom":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"}},"type":"object"},"RadioLight":{"title":"Radio Light","properties":{"name":{"description":"Radio name","type":"string"},"slug":{"description":"Radio slug. Used as radio identifier","type":"string"},"countryCode":{"description":"Radio country code, 2 letters ISO 3166-2","type":"string"},"countryName":{"description":"Radio country name","example":"FR","type":"string"},"cityName":{"description":"Radio city name","type":"string"},"timeZone":{"description":"Radio timezone","example":"Europe\/Paris","type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"Radio":{"properties":{"name":{"description":"Radio name","type":"string"},"slug":{"description":"Radio slug. Used as radio identifier","type":"string"},"countryCode":{"description":"Radio country code, 2 letters ISO 3166-2","type":"string"},"countryName":{"description":"Radio country name","example":"FR","type":"string"},"cityName":{"description":"Radio city name","type":"string"},"timeZone":{"description":"Radio timezone","example":"Europe\/Paris","type":"string"},"reach":{"description":"Sum of followers on social platforms","type":"integer"},"imageUrl":{"type":"string"}},"type":"object"},"RadioLight2":{"properties":{"name":{"description":"Radio name","type":"string"},"slug":{"description":"Radio slug. Used as radio identifier","type":"string"},"countryCode":{"description":"Radio country code, 2 letters ISO 3166-2","type":"string"},"countryName":{"description":"Radio country name","example":"FR","type":"string"},"cityName":{"description":"Radio city name","type":"string"},"timeZone":{"description":"Radio timezone","example":"Europe\/Paris","type":"string"},"reach":{"description":"Sum of followers on social platforms","type":"integer"},"firstAiredAt":{"description":"First aired at","type":"string","format":"date-time"},"imageUrl":{"description":"Logo Url","type":"string"}},"type":"object"},"SongBroadcast":{"properties":{"song":{"$ref":"#\/components\/schemas\/SongLight"},"airedAt":{"type":"string","format":"date-time"},"duration":{"type":"integer"}},"type":"object"},"Identifier":{"properties":{"platformName":{"type":"string"},"platformCode":{"type":"string"},"identifier":{"type":"string"},"url":{"type":"string"}},"type":"object"},"Platform":{"title":"Platform","properties":{"name":{"description":"Platform name","type":"string"},"code":{"description":"Platform code","type":"string"}},"type":"object"},"Country":{"properties":{"name":{"type":"string"},"countryCode":{"type":"string"}},"type":"object"},"Genre":{"properties":{"root":{"type":"string"},"sub":{"items":{"type":"string"},"type":"array"}},"type":"object"},"City":{"properties":{"name":{"type":"string"},"region":{"type":"string"},"countryCode":{"type":"string"},"cityKey":{"type":"string"}},"type":"object"},"Distributor":{"properties":{"value":{"type":"string"}},"type":"object"},"Attribute":{"properties":{"attribute":{"type":"string"}},"type":"object"},"LyricsAttribute":{"properties":{"value":{"type":"string"}},"type":"object"},"VenueLight":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"cityName":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"region":{"type":"string"},"imageUrl":{"type":"string"},"type":{"type":"string"}},"type":"object"},"MetricSong2":{"properties":{"song":{"$ref":"#\/components\/schemas\/SongLightReleaseDate"},"audience":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"popularity":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"custom":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"duration":{"type":"integer"},"audio":{"$ref":"#\/components\/schemas\/Audio"}},"type":"object"},"Song":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"isrc":{"type":"string"},"creditName":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"mainArtists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"releaseDate":{"type":"string","format":"date-time"},"label":{"type":"string"},"copyright":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"duration":{"type":"integer"},"explicit":{"type":"boolean"}},"type":"object"},"Song2":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"isrc":{"$ref":"#\/components\/schemas\/Isrc"},"creditName":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"mainArtists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"releaseDate":{"type":"string","format":"date-time"},"label":{"type":"string"},"copyright":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"duration":{"type":"integer"},"explicit":{"type":"boolean"},"genres":{"items":{"$ref":"#\/components\/schemas\/Genre"},"type":"array"},"composers":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Song3":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"isrc":{"$ref":"#\/components\/schemas\/Isrc"},"iswcs":{"items":{"type":"string"},"type":"array"},"creditName":{"type":"string"},"artists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"mainArtists":{"items":{"$ref":"#\/components\/schemas\/ArtistLight"},"type":"array"},"releaseDate":{"type":"string","format":"date-time"},"copyright":{"type":"string"},"appUrl":{"type":"string"},"imageUrl":{"type":"string"},"duration":{"type":"integer"},"explicit":{"type":"boolean"},"genres":{"items":{"$ref":"#\/components\/schemas\/Genre"},"type":"array"},"composers":{"items":{"type":"string"},"type":"array"},"producers":{"items":{"type":"string"},"type":"array"},"labels":{"items":{"$ref":"#\/components\/schemas\/Label3"},"type":"array"},"audio":{"$ref":"#\/components\/schemas\/Audio"},"languageCode":{"type":"string"},"distributor":{"type":"string"},"credits":{"items":{"$ref":"#\/components\/schemas\/Collaborator2"},"type":"array"}},"type":"object"},"LyricsAnalysis":{"properties":{"themes":{"items":{"type":"string"},"type":"array"},"moods":{"items":{"type":"string"},"type":"array"},"culturalReferencePeople":{"items":{"type":"string"},"type":"array"},"culturalReferenceNonPeople":{"items":{"type":"string"},"type":"array"},"brands":{"items":{"type":"string"},"type":"array"},"locations":{"items":{"type":"string"},"type":"array"},"narrativeStyle":{"type":"string"},"emotionalIntensityScore":{"type":"integer"},"complexityScore":{"type":"integer"},"repetitivenessScore":{"type":"integer"},"rhymeSchemeScore":{"type":"integer"},"imageryScore":{"type":"integer"}},"type":"object"},"AlbumLightDefault":{"properties":{"name":{"type":"string"},"creditName":{"type":"string"},"releaseDate":{"type":"string","format":"date-time"},"uuid":{"type":"string"},"default":{"type":"boolean"},"type":{"type":"string"}},"type":"object"},"SongVideoPlot":{"properties":{"date":{"type":"string","format":"date-time"},"videoPlots":{"items":{"$ref":"#\/components\/schemas\/Plot"},"type":"array"}},"type":"object"},"Rank3":{"title":"Song Chart Rank","properties":{"chart":{"$ref":"#\/components\/schemas\/Chart"},"position":{"type":"integer"},"positionEvolution":{"type":"integer"},"peakPosition":{"type":"integer"},"peakDate":{"type":"string","format":"date-time"},"entryState":{"type":"string"},"entryDate":{"type":"string","format":"date-time"},"rankDate":{"type":"string","format":"date-time"},"oldPosition":{"type":"integer"},"current":{"type":"boolean"},"timeOnChart":{"type":"integer"},"timeOnChartUnit":{"type":"string"}},"type":"object"},"Position":{"title":"Playlist Position","properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight"},"position":{"type":"integer"},"peakPosition":{"type":"integer"},"entryDate":{"type":"string","format":"date-time"},"exitDate":{"type":"string","format":"date-time"},"positionDate":{"type":"string","format":"date-time"},"peakPositionDate":{"type":"string","format":"date-time"}},"type":"object"},"Position2":{"properties":{"playlist":{"$ref":"#\/components\/schemas\/PlaylistLight2"},"position":{"type":"integer"},"peakPosition":{"type":"integer"},"entryDate":{"type":"string","format":"date-time"},"exitDate":{"type":"string","format":"date-time"},"positionDate":{"type":"string","format":"date-time"},"peakPositionDate":{"type":"string","format":"date-time"}},"type":"object"},"MusicFull":{"properties":{"identifier":{"type":"string"},"title":{"type":"string"},"authorName":{"type":"string"},"url":{"type":"string"},"imgUrl":{"type":"string"},"song":{"$ref":"#\/components\/schemas\/SongLight"},"latestCrawlDate":{"type":"string","format":"date-time"},"firstCrawlDate":{"type":"string","format":"date-time"}},"type":"object"},"Music":{"title":"TikTok music","properties":{"identifier":{"type":"string"},"title":{"type":"string"},"authorName":{"type":"string"},"url":{"type":"string"},"imgUrl":{"type":"string"}},"type":"object"},"Label":{"properties":{"label":{"type":"string"}},"type":"object"},"MetricVenue":{"properties":{"venue":{"$ref":"#\/components\/schemas\/VenueLight"},"social":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"streaming":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"popularity":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"custom":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialView":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialLike":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialPost":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"},"socialFollowing":{"items":{"$ref":"#\/components\/schemas\/PlatformMetric"},"type":"array"}},"type":"object"},"Venue":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"cityName":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"region":{"type":"string"},"imageUrl":{"type":"string"},"address":{"type":"string"},"zipCode":{"type":"string"},"geo":{"$ref":"#\/components\/schemas\/Coordinates"},"capacity":{"type":"string"},"type":{"type":"string"},"website":{"type":"string"}},"type":"object"},"Event2":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"date":{"type":"string","format":"date-time"},"type":{"type":"string"},"status":{"type":"string"},"venue":{"$ref":"#\/components\/schemas\/VenueLight"},"price":{"$ref":"#\/components\/schemas\/Price"},"artists":{"items":{"$ref":"#\/components\/schemas\/Artist3"},"type":"array"},"identifiers":{"items":{"$ref":"#\/components\/schemas\/PlatformIdentifier2"},"type":"array"},"ticketUrls":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Work":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"iswc":{"type":"string"},"writers":{"items":{"$ref":"#\/components\/schemas\/Writer"},"type":"array"},"publishers":{"items":{"$ref":"#\/components\/schemas\/Publisher2"},"type":"array"}},"type":"object"},"WorkLight":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"}},"type":"object"},"Label2":{"properties":{"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"Plot2":{"properties":{"identifier":{"type":"string"},"value":{"type":"integer"}},"type":"object"},"Chart":{"properties":{"name":{"type":"string"},"type":{"type":"string"},"slug":{"type":"string"},"platform":{"type":"string"},"frequency":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"cityName":{"type":"string"},"maxResultsCount":{"type":"integer"},"webUrl":{"type":"string"}},"type":"object"},"PlatformMetric":{"properties":{"platformCode":{"type":"string"},"metricType":{"type":"string"},"total":{"type":"integer"},"week":{"$ref":"#\/components\/schemas\/PeriodMetric"},"month":{"$ref":"#\/components\/schemas\/PeriodMetric"},"quarter":{"$ref":"#\/components\/schemas\/PeriodMetric"}},"type":"object"},"CityPlot":{"properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"integer"},"countryName":{"type":"string"},"countryCode":{"type":"string"},"region":{"type":"string"},"cityName":{"type":"string"}},"type":"object"},"CountryPlot":{"properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"integer"},"countryName":{"type":"string"},"countryCode":{"type":"string"}},"type":"object"},"Top":{"properties":{"mentions":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"hashtags":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"posts":{"items":{"$ref":"#\/components\/schemas\/Post"},"type":"array"},"reels":{"items":{"$ref":"#\/components\/schemas\/Reel"},"type":"array"}},"type":"object"},"Audience2":{"title":"Audience","properties":{"stats":{"$ref":"#\/components\/schemas\/Stats"},"audienceLike":{"$ref":"#\/components\/schemas\/AudienceDetail"},"audienceFollower":{"$ref":"#\/components\/schemas\/AudienceDetail"},"brandsAffinity":{"items":{"type":"string"},"type":"array"},"interests":{"items":{"type":"string"},"type":"array"},"relevantTags":{"items":{"$ref":"#\/components\/schemas\/RelevantTag"},"type":"array"}},"type":"object"},"Venue2":{"properties":{"name":{"type":"string"},"cityName":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"capacity":{"type":"string"},"popularity":{"type":"string"},"url":{"type":"string"}},"type":"object"},"Price":{"properties":{"currency":{"type":"string"},"min":{"type":"number","format":"number"},"max":{"type":"number","format":"number"}},"type":"object"},"TopRadio":{"properties":{"name":{"description":"Radio name","type":"string"},"slug":{"description":"Radio slug. Used as radio identifier","type":"string"},"countryCode":{"description":"Radio country code, 2 letters ISO 3166-2","type":"string"},"countryName":{"description":"Radio country name","example":"FR","type":"string"},"cityName":{"description":"Radio city name","type":"string"},"timeZone":{"description":"Radio timezone","example":"Europe\/Paris","type":"string"},"reach":{"description":"Sum of followers on social platforms","type":"integer"},"genres":{"description":"","items":{"type":"string"},"type":"array"},"trackAge":{"description":"Frontline, catalog, mixed","type":"string"},"imageUrl":{"type":"string"}},"type":"object"},"ChartLight2":{"properties":{"name":{"type":"string"},"type":{"type":"string"},"slug":{"type":"string"},"platform":{"type":"string"},"frequency":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"cityName":{"type":"string"},"maxResultsCount":{"type":"integer"},"webUrl":{"type":"string"},"metric":{"$ref":"#\/components\/schemas\/Metric"}},"type":"object"},"Coordinates":{"properties":{"latitude":{"type":"number","format":"number"},"longitude":{"type":"number","format":"number"}},"type":"object"},"Artist3":{"properties":{"name":{"type":"string"},"artist":{"$ref":"#\/components\/schemas\/ArtistLight"}},"type":"object"},"PlatformIdentifier2":{"properties":{"platformName":{"type":"string"},"platformCode":{"type":"string"},"identifier":{"type":"string"},"url":{"type":"string"}},"type":"object"},"TopPlaylistLight":{"title":"Playlist Light","properties":{"uuid":{"type":"string"},"name":{"type":"string"},"identifier":{"type":"string"},"platform":{"type":"string"},"countryCode":{"type":"string"},"latestCrawlDate":{"type":"string","format":"date-time"},"latestTrackCount":{"type":"integer"},"latestSubscriberCount":{"type":"integer"},"imageUrl":{"type":"string"},"type":{"type":"string"},"ownerName":{"type":"string"},"trackAge":{"type":"string"},"trackAddedPercent":{"type":"number","format":"number"},"genres":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Audio":{"properties":{"acousticness":{"type":"number","format":"number"},"danceability":{"type":"number","format":"number"},"energy":{"type":"number","format":"number"},"instrumentalness":{"type":"number","format":"number"},"key":{"type":"integer"},"liveness":{"type":"number","format":"number"},"loudness":{"type":"number","format":"number"},"mode":{"type":"integer"},"speechiness":{"type":"number","format":"number"},"tempo":{"type":"number","format":"number"},"timeSignature":{"type":"integer"},"valence":{"type":"number","format":"number"}},"type":"object"},"Isrc":{"properties":{"value":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"}},"type":"object"},"Label3":{"properties":{"name":{"type":"string"},"type":{"type":"string"}},"type":"object"},"Collaborator2":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"roles":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Writer":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"}},"type":"object"},"Publisher2":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"share":{"type":"number","format":"number"},"adminPublisher":{"$ref":"#\/components\/schemas\/AdminPublisher"},"relatedWriters":{"items":{"$ref":"#\/components\/schemas\/Writer"},"type":"array"}},"type":"object"},"PeriodMetric":{"properties":{"volume":{"type":"integer"},"percent":{"type":"number","format":"number"}},"type":"object"},"CodeWeight":{"title":"Code Weight","properties":{"code":{"type":"string"},"weight":{"type":"number","format":"number"}},"type":"object"},"Post":{"properties":{"likeCount":{"type":"integer"},"commentCount":{"type":"integer"},"date":{"type":"string","format":"date-time"},"imageUrl":{"type":"string"},"url":{"type":"string"},"text":{"type":"string"},"mentions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Reel":{"title":"Reel","properties":{"date":{"type":"string","format":"date-time"},"url":{"type":"string"},"text":{"type":"string"},"likeCount":{"type":"integer"},"commentCount":{"type":"integer"},"playCount":{"type":"integer"},"mentions":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Stats":{"properties":{"followerCount":{"type":"integer"},"postCount":{"type":"integer"},"viewCount":{"type":"integer"},"engagementCount":{"type":"integer"},"averageLikesPerPost":{"type":"number","format":"number"},"averageCommentsPerPost":{"type":"number","format":"number"},"averageViewsPerPost":{"type":"number","format":"number"},"engagementRate":{"type":"number","format":"number"},"averageReelsPlays":{"type":"integer"}},"type":"object"},"AudienceDetail":{"title":"Audience Detail","properties":{"genders":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"ages":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"gendersPerAge":{"items":{"$ref":"#\/components\/schemas\/GenderPerAge"},"type":"array"},"ethnicities":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"languages":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"countries":{"items":{"$ref":"#\/components\/schemas\/CountryWeight"},"type":"array"},"cities":{"items":{"$ref":"#\/components\/schemas\/CityWeight"},"type":"array"},"notableUsers":{"items":{"$ref":"#\/components\/schemas\/User"},"type":"array"},"types":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"credibility":{"type":"number","format":"number"},"credibilityClass":{"type":"string"},"reachabilities":{"items":{"$ref":"#\/components\/schemas\/CodeWeight"},"type":"array"},"notableUsersRatio":{"type":"number","format":"number"},"lookalikes":{"items":{"$ref":"#\/components\/schemas\/Lookalike"},"type":"array"},"interests":{"items":{"$ref":"#\/components\/schemas\/AffinityWeight"},"type":"array"},"brandAffinities":{"items":{"$ref":"#\/components\/schemas\/AffinityWeight"},"type":"array"}},"type":"object"},"RelevantTag":{"title":"Relevant Tag","properties":{"name":{"type":"string"},"distance":{"type":"number","format":"number"},"freq":{"type":"number","format":"number"}},"type":"object"},"Metric":{"properties":{"type":{"type":"string"},"description":{"type":"string"}},"type":"object"},"AdminPublisher":{"properties":{"uuid":{"type":"string"},"name":{"type":"string"},"share":{"type":"number","format":"number"}},"type":"object"},"GenderPerAge":{"properties":{"code":{"type":"string"},"maleWeight":{"type":"number","format":"number"},"femaleWeight":{"type":"number","format":"number"}},"type":"object"},"CountryWeight":{"properties":{"weight":{"type":"number","format":"number"},"countryName":{"type":"string"},"countryCode":{"type":"string"}},"type":"object"},"CityWeight":{"properties":{"weight":{"type":"number","format":"number"},"countryName":{"type":"string"},"countryCode":{"type":"string"},"region":{"type":"string"},"cityName":{"type":"string"}},"type":"object"},"User":{"properties":{"username":{"type":"string"},"fullName":{"type":"string"},"followerCount":{"type":"integer"},"engagementCount":{"type":"integer"},"url":{"type":"string"},"imageUrl":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"}},"type":"object"},"Lookalike":{"title":"Lookalike","properties":{"username":{"type":"string"},"fullName":{"type":"string"},"followerCount":{"type":"integer"},"engagementCount":{"type":"integer"},"url":{"type":"string"},"imageUrl":{"type":"string"},"countryCode":{"type":"string"},"countryName":{"type":"string"},"score":{"type":"number","format":"number"}},"type":"object"},"AffinityWeight":{"title":"Affinity Weight","properties":{"name":{"type":"string"},"weight":{"type":"number","format":"number"},"affinity":{"type":"number","format":"number"}},"type":"object"}},"securitySchemes":{"APP_ID":{"name":"x-app-id","type":"apiKey","in":"header","description":"Value {APP-ID}"},"API_KEY":{"name":"x-api-key","type":"apiKey","in":"header","description":"Value: {API-KEY}"}}}}