Boomplay
Boomplay, Africa's biggest music streaming service, as JSON: songs, artists with followers and total plays, albums, playlists, Top 100 charts for 179 countries with position and movement, trending songs by genre, artist rankings, comments, videos, podcasts and search.
/boomplay/v1/search_songs1 creditSearch Boomplay songs by text in one market. Real paging: 20 per page by default, up to 100 (measured: 100 → 98 rows; the source leaves out songs not licensed in the market, so a page can be a row or two short and still have a next page). Each row is a full song row.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–100 | Rows per page, 20 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/search_videos1 creditSearch Boomplay videos (music videos, interviews, documentaries, live shows…) by text, plus the artist Boomplay ranks as the best match for the query. Paging: 20 per page, up to 50.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/search_users1 creditSearch Boomplay user profiles by name. Paging: 20 per page, up to 100.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–100 | Rows per page, 20 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/suggest1 creditAutocomplete: what Boomplay suggests while you type (artists, songs, albums, playlists…), 20 suggestions per query.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/search_artists2 creditsSearch artists by name on boomplay.com's Artists tab: 12 per page, real paging (page 2 = the next 12). Each row: web id, name, link, the play count as the site prints it ("1.3b") and its approximate integer. Pass the web id to `artist` for the full record.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/search_albums2 creditsSearch albums by title on boomplay.com's Albums tab: 12 per page, real paging. Pass the web id to `album` for every track.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/search_playlists2 creditsSearch playlists by title on boomplay.com's Playlists tab: 12 per page, real paging.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/search_podcasts2 creditsSearch podcasts (shows) and podcast episodes on boomplay.com's Podcasts tab.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search text. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/song2 creditsOne song: title, every credited artist, album, record label, release year, duration, explicit flag, favourite count and comment count (both equal to the song page's own buttons), number of top comments, music-video id, whether lyrics exist, and its availability in the market. Play count and genre are on `song_page`; lyrics sync status on `lyrics_info`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| song | required | — | Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/lyrics_info1 creditWhether a song has lyrics on Boomplay, whether they are time-synced (karaoke-style), their review status and the agree / disagree votes, and the lyrics page link. The lyrics text itself is not returned.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| song | required | — | Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/song_page2 creditsWhat a song's boomplay.com page prints: play count as printed ("14m") and its approximate integer, exact favourite / share / comment counts, genre(s), year of release and the page's Similar Songs shelf. Read from the web page of the chosen market (NG, GH, KE, ZA or US); a song that is not licensed there returns NOT_FOUND saying so.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| song | required | — | Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/similar_songs1 creditSongs similar to a song — Boomplay's own recommendation list (20 songs). Each row carries the play / favourite / share / comment counters stored in Boomplay's recommendation index, named *_snapshot: they lag the live counts (measured: 294,112 snapshot plays vs 2.8m on the song page), so read `song` / `song_page` for current numbers.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| song | required | — | Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/song_playlists1 creditPublic playlists that contain a song (one list, up to 45 measured; the source does not page it).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| song | required | — | Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/artist1 creditOne artist: bio, gender, country, follower count, total plays, favourites, shares, comments, downloads, counts of songs / albums / videos / playlists, the linked user profile, plus the first 20 songs, 20 albums and 20 videos.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/artist_songs1 creditEvery song of an artist, 20 per page (the source's fixed page size), newest first. Page 1 carries the artist's name and `total` (the song count); later pages carry the rows only.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/artist_albums1 creditEvery album / single / EP of an artist with play and favourite counts, 20 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/artist_videos1 creditEvery video of an artist with view, favourite, comment, share and download counts, 20 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/similar_artists2 creditsAn artist's boomplay.com page: current rank and all-time rank on Boomplay in the market, country, favourite / share / comment counts and the Similar Artists list (10 measured on Burna Boy).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/artist_playlists2 creditsPlaylists shown on an artist's boomplay.com page, with the page's total playlist count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link. |
| country = NG | optional | NG · GH · KE · ZA · US | Market whose boomplay.com page to read: the site shows each market its own licensed catalogue and its own rankings (Davido: #62 now / #6 all time in Nigeria, #121 / #7 in the US). Default NG. |
/boomplay/v1/artist_rankings1 creditBoomplay's artist ranking in a market for the day, the week or all time: rank, follower count. Up to 100 per page (100 rows measured per period).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| period = week | optional | day · week · all_time | Ranking period. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 50 | optional | 1–100 | Rows per page, 50 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/browse_artists1 creditBrowse Boomplay's artist directory by genre, gender, region and first letter, ordered by popularity, with total plays and followers. Up to 100 per page. Filter values: `artist_filters`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| genre | optional | — | Genre id from `artist_filters` (0 / empty = all). |
| gender = all | optional | all · male · female · group | Artist gender. |
| region = all | optional | all · nigeria · kenya · tanzania · ghana · europe_north_america · other | Artist region. |
| letter | optional | — | First letter A-Z, or '#' for others. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 50 | optional | 1–100 | Rows per page, 50 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/artist_filtersfreeThe filter values `browse_artists` accepts: genres (id + name), genders, regions, letters.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/album1 creditOne album / single / EP with every track: type, release year, artist, play / favourite / share / comment / download counts, description.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| album | required | — | Boomplay album id: the numeric id or the EQ… web id, or a boomplay.com/albums/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/album_recommendations1 creditAlbums / playlists Boomplay recommends next to an album. Up to 50 per page, real paging.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| album | required | — | Boomplay album id: the numeric id or the EQ… web id, or a boomplay.com/albums/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/playlist1 creditOne playlist with ALL its tracks in one answer (200 measured on a 200-song chart), owner (name, country, followers, verified label), description, play / favourite / share / comment / download counts and last update. Chart playlists carry each track's movement in `rank_change`. Songs not licensed in the market are left out by the source, so `track_count` can be below `song_count`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| playlist | required | — | Boomplay playlist id: the numeric id or the EQ… web id, or a boomplay.com/playlists/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/playlist_recommendations1 creditPlaylists Boomplay recommends next to a playlist. Up to 50 per page, real paging.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| playlist | required | — | Boomplay playlist id: the numeric id or the EQ… web id, or a boomplay.com/playlists/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/browse_playlists1 creditBrowse Boomplay's playlist directory by genre, ordered by popularity, with play counts and owners. Up to 50 per page. Genre ids: `playlist_genres`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| genre | optional | — | Genre id from `playlist_genres` (0 / empty = all). |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/playlist_genresfreeGenre ids `browse_playlists` accepts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/charts1 creditEvery chart shelf of a market: weekly, daily and monthly chart playlists (the market's own Top 100, Africa, International, Christian & Gospel, other countries), weekly top artists and weekly top albums — the first 6 of each. Use `chart_list` / `chart` / `top_artists` / `top_albums` for full lists.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/chart_list1 creditAll chart playlists of one period (weekly: 40 in NG, daily 42, monthly 40): Top 100 of each country Boomplay charts, Africa, International, Christian & Gospel, Top New Songs, Daily Rising.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| period = weekly | optional | weekly · daily · monthly | Chart period. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/chart2 creditsOne chart with its ranked songs (Top 100): position, movement since the last edition (+/-), play data of each song. Pick it by id, or by `region` + `period` (e.g. region 'Kenya' + period 'weekly' = Top 100 Kenya; 'Africa', 'International', 'Christian & Gospel' also work).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| chart | optional | — | Chart playlist id / web id / link (from `chart_list`). |
| region | optional | — | Chart region: a country name or code, 'Africa', 'International', 'Christian & Gospel', or a chart name such as 'Top New Songs Nigeria'. Used when `chart` is empty. |
| period = weekly | optional | weekly · daily · monthly | Chart period when picking by region. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/top_artists1 creditThe market's weekly top artists chart (100 artists) in rank order, with images.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/top_albums1 creditThe market's weekly top albums chart (100 albums) with rank, artist and release year.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/trending1 creditEvery trending shelf of a market: trending songs (with genre tags), trending albums, new releases, just-updated playlists, playlists, artists (followers + total plays), podcast episodes and podcasts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/trending_songs1 creditA market's trending songs (100) — 'hot', 'new', or one genre (ids from `trending_tags`), with movement and favourite / share / comment counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| tag = hot | optional | — | 'hot' (default), 'new', or a genre tag id from `trending_tags`. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/home1 creditThe Boomplay app's home page for a market: every shelf with its items.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/home_section1 creditOne home shelf in full by its id (from `home`).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| section | required | — | Shelf id from `home`. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/popular_songs1 creditThe 50 songs most searched / played from search in a market, ranked, with movement.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/popular_artists1 creditThe 50 artists most popular on search in a market, ranked, with movement.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/trending_searches2 creditsThe search keywords Boomplay promotes in a market (search-bar shortcuts and hot keywords).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/genresfreeBoomplay's music genres (id, name, images).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/genre1 creditOne genre: its top artists (total plays), albums (plays, availability by country) and playlists (plays, owner), paged together, up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| genre | required | — | Genre id from `genres`. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/video1 creditOne video: title, category, artist, duration, description, view / favourite / comment / share / download counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| video | required | — | Boomplay video id: the numeric id or the EQ… web id, or a boomplay.com/video/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/videos1 creditVideos of one category, newest first, up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category = music_videos | optional | music_videos · interviews · documentaries · talk_shows · comedy · concerts | Video category. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/video_categoriesfreeThe video categories `videos` accepts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/podcast1 creditOne podcast (show): description, language, author, category, copyright, explicit / complete flags, episode count, play / favourite / comment / share counts, last episode date and its newest 20 episodes.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| podcast | required | — | Boomplay podcast id (digits), or a boomplay.com/podcasts/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/podcast_episodes1 creditEvery episode of a podcast, newest first, up to 100 per page; `total` = the show's episode count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| podcast | required | — | Boomplay podcast id (digits), or a boomplay.com/podcasts/… link. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–100 | Rows per page, 20 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/episode1 creditOne podcast episode with its show, author, duration, date and counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| episode | required | — | Boomplay episode id (digits), or a boomplay.com/episode/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/browse_podcasts1 creditPodcasts by category, most popular or newest first, up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category = 0 | optional | — | Category id from `podcast_categories` (0 = all). |
| sort = popular | optional | popular · new | Order. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/browse_episodes1 creditPodcast episodes by category, most popular or newest first, up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category = 0 | optional | — | Category id from `podcast_categories` (0 = all). |
| sort = popular | optional | popular · new | Order. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/podcast_home1 creditThe podcast home of a market: every shelf of podcasts and episodes.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/podcast_trending2 creditsTrending podcasts and trending episodes of a market.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/podcast_categoriesfreePodcast categories (ids for browse_podcasts).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/buzz_posts1 creditBoomplay Buzz — the app's music news / social feed: hot posts with author, text, media, the linked song / album / playlist and view / favourite / share / comment counts. Up to 50 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–50 | Rows per page, 20 by default, at most 50. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/buzz_post1 creditOne Buzz post in full: text, author, tag, media, the linked item and its view / favourite / share / comment counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| post | required | — | Boomplay post id (digits), or a boomplay.com/buzz/… link. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/comments1 creditComments on a song, album, artist, playlist, video, podcast, episode or Buzz post: text (emoji decoded), date, likes, reply count, the comment it replies to, and the commenter (name, country, VIP). sort=newest pages through every comment (up to 100 per page; `total` = the item's comment count); sort=top is the short top-comments list (one page).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| type | required | song · album · artist · playlist · video · podcast · episode · post | What the id points to. |
| id | required | — | The item's id, EQ… web id or boomplay.com link. |
| sort = newest | optional | newest · top | newest (default) or top. |
| page = 1 | optional | 1–500 | 1-based page number. |
| per_page = 20 | optional | 1–100 | Rows per page, 20 by default, at most 100. |
| country = NG | optional | — | Market whose catalogue, charts and licensing to read: an ISO country code or a country name (179 countries; default NG = Nigeria). Charts, trending, home, rankings and which songs are available all follow it. |
/boomplay/v1/user1 creditA public Boomplay user profile: name, Boomplay ID, verified label, follower / following counts as printed, about block (bio, country, gender) and the public playlists on the profile.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Boomplay user id (digits), or a boomplay.com/users/… link. |
curl -X POST https://api.reefapi.com/boomplay/v1/search_songs \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"burna boy"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.