{"openapi":"3.0.0","paths":{"/api/v1/artists":{"get":{"description":"Returns a paginated list of artists sorted by streams.","operationId":"V1ArtistsController_browse","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","description":"Max 100","schema":{"type":"number"}},{"name":"letter","required":true,"in":"query","schema":{"type":"string"}},{"name":"country","required":false,"in":"query","description":"ISO country code e.g. NG","schema":{"type":"string"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"sortBy","required":false,"in":"query","schema":{"enum":["name","totalStreams","monthlyListeners"],"type":"string"}},{"name":"q","required":false,"in":"query","description":"Search by name","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Browse artists","tags":["Artists"]}},"/api/v1/artists/{slug}/history":{"get":{"description":"Returns 90 days of daily stream snapshots.","operationId":"V1ArtistsController_getHistory","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get artist stream history","tags":["Artists"]}},"/api/v1/artists/{slug}":{"get":{"description":"Returns full artist profile including streams, listeners, charts, awards and top songs.","operationId":"V1ArtistsController_getBySlug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get artist by slug","tags":["Artists"]}},"/api/v1/songs/search":{"get":{"operationId":"V1SongsController_search","parameters":[{"name":"title","required":true,"in":"query","schema":{"example":"essence","type":"string"}},{"name":"artistName","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Search songs by title","tags":["Songs"]}},"/api/v1/songs/{slug}/history":{"get":{"operationId":"V1SongsController_getHistory","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid-essence","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get song stream history","tags":["Songs"]}},"/api/v1/songs/{slug}/songs":{"get":{"operationId":"V1SongsController_getArtistSongs","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get all songs by artist slug","tags":["Songs"]}},"/api/v1/songs/{slug}":{"get":{"operationId":"V1SongsController_getBySlug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid-essence","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get song by slug","tags":["Songs"]}},"/api/v1/milestones/recent":{"get":{"operationId":"V1MilestonesController_getRecent","parameters":[{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get recent milestones","tags":["Milestones"]}},"/api/v1/milestones/artists/{tier}":{"get":{"operationId":"V1MilestonesController_getArtistTier","parameters":[{"name":"tier","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"number"}},{"name":"limit","required":true,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"tags":["Milestones"]}},"/api/v1/milestones/songs/{tier}":{"get":{"operationId":"V1MilestonesController_getSongTier","parameters":[{"name":"tier","required":true,"in":"path","description":"e.g. 50m, 100m, 500m, 1b, 2b","schema":{"example":"1b","type":"string"}},{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get songs by milestone tier","tags":["Milestones"]}},"/api/v1/milestones/timeline/{artistSlug}":{"get":{"operationId":"V1MilestonesController_getTimeline","parameters":[{"name":"artistSlug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get artist milestone timeline","tags":["Milestones"]}},"/api/v1/milestones/facts/{artistSlug}/streams/{threshold}":{"get":{"operationId":"V1MilestonesController_getArtistStreamFact","parameters":[{"name":"artistSlug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}},{"name":"threshold","required":true,"in":"path","schema":{"example":10000000000,"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get artist stream milestone fact","tags":["Milestones"]}},"/api/v1/milestones/facts/{artistSlug}/listeners/{threshold}":{"get":{"operationId":"V1MilestonesController_getArtistListenerFact","parameters":[{"name":"artistSlug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}},{"name":"threshold","required":true,"in":"path","schema":{"example":10000000,"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get artist listener milestone fact","tags":["Milestones"]}},"/api/v1/milestones/facts/{artistSlug}/songs/{songSlug}/streams/{threshold}":{"get":{"operationId":"V1MilestonesController_getSongStreamFact","parameters":[{"name":"artistSlug","required":true,"in":"path","schema":{"example":"wizkid","type":"string"}},{"name":"songSlug","required":true,"in":"path","schema":{"example":"wizkid-essence","type":"string"}},{"name":"threshold","required":true,"in":"path","schema":{"example":1000000000,"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"tags":["Milestones"]}},"/api/v1/leaderboard/streams":{"get":{"operationId":"V1LeaderboardController_getStreams","parameters":[{"name":"limit","required":false,"in":"query","description":"Max 100","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"country","required":false,"in":"query","description":"ISO country code","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Top artists by total streams","tags":["Leaderboard"]}},"/api/v1/leaderboard/listeners":{"get":{"operationId":"V1LeaderboardController_getListeners","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"country","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Top artists by monthly listeners","tags":["Leaderboard"]}},"/api/v1/leaderboard/songs":{"get":{"operationId":"V1LeaderboardController_getSongs","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Top songs by total streams","tags":["Leaderboard"]}},"/api/v1/trending/artists":{"get":{"operationId":"V1TrendingController_getArtists","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"country","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Trending artists by momentum score","tags":["Trending"]}},"/api/v1/trending/songs":{"get":{"operationId":"V1TrendingController_getSongs","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Trending songs by momentum score","tags":["Trending"]}},"/api/v1/albums":{"get":{"operationId":"V1AlbumsController_browse","parameters":[{"name":"page","required":false,"in":"query","schema":{"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}},{"name":"isAfrobeats","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"albumType","required":false,"in":"query","schema":{"enum":["album","single","ep"],"type":"string"}},{"name":"sortBy","required":false,"in":"query","schema":{"enum":["totalStreams","releaseDate","dailyStreams"],"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Browse albums","tags":["Albums"]}},"/api/v1/albums/{slug}":{"get":{"operationId":"V1AlbumsController_getBySlug","parameters":[{"name":"slug","required":true,"in":"path","schema":{"example":"wizkid-more-love-less-ego","type":"string"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get album by slug","tags":["Albums"]}},"/api/v1/charts":{"get":{"operationId":"V1ChartsController_getAvailable","parameters":[],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get available charts","tags":["Charts"]}},"/api/v1/charts/{chartName}/{territory}":{"get":{"operationId":"V1ChartsController_getChart","parameters":[{"name":"chartName","required":true,"in":"path","schema":{"example":"official_afrobeats_chart","type":"string"}},{"name":"territory","required":true,"in":"path","schema":{"example":"UK","type":"string"}},{"name":"limit","required":false,"in":"query","description":"Max 200","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"api-key":[]}],"summary":"Get chart entries","tags":["Charts"]}}},"info":{"title":"TooXclusive API","description":"The official TooXclusive music data API — streaming stats, milestones, charts and more for 20,000+ artists and 1.2M songs.","version":"1.0","contact":{"name":"TooXclusive","url":"https://developers.tooxclusive.com","email":"api@tooxclusive.com"},"license":{"name":"Proprietary","url":"https://tooxclusive.com/terms"}},"tags":[],"servers":[{"url":"https://api.tooxclusive.com","description":"Production"}],"components":{"securitySchemes":{"api-key":{"scheme":"bearer","bearerFormat":"API Key","type":"http","description":"Enter your API key: txc_live_..."}},"schemas":{}}}