Boomplay charts, artists and songs for every African market, as JSON
- endpoints
- 58
- credits per call
- 0–2
Boomplay (boomplay.com) is the largest music streaming service in Africa.
/boomplay/v1
- POST/boomplay/v1/search_songs1 credit
- POST/boomplay/v1/search_videos1 credit
- POST/boomplay/v1/search_users1 credit
- POST/boomplay/v1/suggest1 credit
- POST/boomplay/v1/search_artists2 credits
- POST/boomplay/v1/search_albums2 credits
- POST/boomplay/v1/search_playlists2 credits
- POST/boomplay/v1/search_podcasts2 credits
- POST/boomplay/v1/song2 credits
- POST/boomplay/v1/lyrics_info1 credit
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Boomplay API
5 of 58 endpoints, ready to run
A country's Top 100 with position and movement
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Boomplay endpoints does ReefAPI ship?
58 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
search_songs
1 crSearch Boomplay songs by text in one market.
- required
- query
- optional
- page, per_page, country
search_videos
1 crSearch Boomplay videos (music videos, interviews, documentaries, live shows…) by text, plus t…
- required
- query
- optional
- page, per_page, country
search_users
1 crSearch Boomplay user profiles by name.
- required
- query
- optional
- page, per_page, country
suggest
1 crAutocomplete.
- required
- query
- optional
- country
search_artists
2 crSearch artists by name on boomplay.com's Artists tab.
- required
- query
- optional
- page, country
search_albums
2 crSearch albums by title on boomplay.com's Albums tab.
- required
- query
- optional
- page, country
search_playlists
2 crSearch playlists by title on boomplay.com's Playlists tab.
- required
- query
- optional
- page, country
search_podcasts
2 crSearch podcasts (shows) and podcast episodes on boomplay.com's Podcasts tab.
- required
- query
- optional
- page, country
song
2 crOne song.
- required
- song
- optional
- country
lyrics_info
1 crWhether a song has lyrics on Boomplay, whether they are time-synced (karaoke-style), their re…
- required
- song
- optional
- country
song_page
2 crWhat a song's boomplay.com page prints.
- required
- song
- optional
- country
similar_songs
1 crSongs similar to a song.
- required
- song
- optional
- country
song_playlists
1 crPublic playlists that contain a song (one list, up to 45 measured.
- required
- song
- optional
- country
artist
1 crOne artist.
- required
- artist
- optional
- country
artist_songs
1 crEvery song of an artist, 20 per page (the source's fixed page size), newest first.
- required
- artist
- optional
- page, country
artist_albums
1 crEvery album / single / EP of an artist with play and favourite counts, 20 per page.
- required
- artist
- optional
- page, country
artist_videos
1 crEvery video of an artist with view, favourite, comment, share and download counts, 20 per page.
- required
- artist
- optional
- page, country
similar_artists
2 crAn artist's boomplay.com page.
- required
- artist
- optional
- country
artist_playlists
2 crPlaylists shown on an artist's boomplay.com page, with the page's total playlist count.
- required
- artist
- optional
- country
artist_rankings
1 crBoomplay's artist ranking in a market for the day, the week or all time.
- required
- —
- optional
- period, page, per_page, country
browse_artists
1 crBrowse Boomplay's artist directory by genre, gender, region and first letter, ordered by popu…
- required
- —
- optional
- genre, gender, region, letter, page, per_page, country
artist_filters
0 crThe filter values browse_artists accepts.
- required
- —
- optional
- country
album
1 crOne album / single / EP with every track.
- required
- album
- optional
- country
album_recommendations
1 crAlbums / playlists Boomplay recommends next to an album.
- required
- album
- optional
- page, per_page, country
playlist
1 crOne playlist with ALL its tracks in one answer (200 measured on a 200-song chart), owner (nam…
- required
- playlist
- optional
- country
playlist_recommendations
1 crPlaylists Boomplay recommends next to a playlist.
- required
- playlist
- optional
- page, per_page, country
browse_playlists
1 crBrowse Boomplay's playlist directory by genre, ordered by popularity, with play counts and ow…
- required
- —
- optional
- genre, page, per_page, country
playlist_genres
0 crGenre ids browse_playlists accepts.
- required
- —
- optional
- country
charts
1 crEvery chart shelf of a market.
- required
- —
- optional
- country
chart_list
1 crAll chart playlists of one period (weekly.
- required
- —
- optional
- period, country
chart
2 crOne chart with its ranked songs (Top 100).
- required
- —
- optional
- chart, region, period, country
top_artists
1 crThe market's weekly top artists chart (100 artists) in rank order, with images.
- required
- —
- optional
- country
top_albums
1 crThe market's weekly top albums chart (100 albums) with rank, artist and release year.
- required
- —
- optional
- country
trending
1 crEvery trending shelf of a market.
- required
- —
- optional
- country
trending_songs
1 crA market's trending songs (100).
- required
- —
- optional
- tag, country
trending_tags
0 crThe tags trending_songs accepts (hot, new, and 25 genres).
- required
- —
- optional
- country
home
1 crThe Boomplay app's home page for a market.
- required
- —
- optional
- country
home_section
1 crOne home shelf in full by its id (from home).
- required
- section
- optional
- country
popular_songs
1 crThe 50 songs most searched / played from search in a market, ranked, with movement.
- required
- —
- optional
- country
popular_artists
1 crThe 50 artists most popular on search in a market, ranked, with movement.
- required
- —
- optional
- country
trending_searches
2 crThe search keywords Boomplay promotes in a market (search-bar shortcuts and hot keywords).
- required
- —
- optional
- country
genres
0 crBoomplay's music genres (id, name, images).
- required
- —
- optional
- country
genre
1 crOne genre.
- required
- genre
- optional
- page, per_page, country
video
1 crOne video.
- required
- video
- optional
- country
videos
1 crVideos of one category, newest first, up to 50 per page.
- required
- —
- optional
- category, page, per_page, country
video_categories
0 crThe video categories videos accepts.
- required
- —
- optional
- country
podcast
1 crOne podcast (show).
- required
- podcast
- optional
- country
podcast_episodes
1 crEvery episode of a podcast, newest first, up to 100 per page.
- required
- podcast
- optional
- page, per_page, country
episode
1 crOne podcast episode with its show, author, duration, date and counts.
- required
- episode
- optional
- country
browse_podcasts
1 crPodcasts by category, most popular or newest first, up to 50 per page.
- required
- —
- optional
- category, sort, page, per_page, country
browse_episodes
1 crPodcast episodes by category, most popular or newest first, up to 50 per page.
- required
- —
- optional
- category, sort, page, per_page, country
podcast_home
1 crThe podcast home of a market.
- required
- —
- optional
- country
podcast_trending
2 crTrending podcasts and trending episodes of a market.
- required
- —
- optional
- country
podcast_categories
0 crPodcast categories (ids for browse_podcasts).
- required
- —
- optional
- country
buzz_posts
1 crBoomplay Buzz.
- required
- —
- optional
- page, per_page, country
buzz_post
1 crOne Buzz post in full.
- required
- post
- optional
- country
comments
1 crComments on a song, album, artist, playlist, video, podcast, episode or Buzz post.
- required
- type, id
- optional
- sort, page, per_page, country
user
1 crA public Boomplay user profile.
- required
- user
- optional
- —
Every parameter, every allowed value →
Missing a Boomplay endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Boomplay API works
Boomplay is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a country's chart to the artists behind it
Read a market's weekly Top 100, then open the artists and their audience.
Top 100 Kenya: position, movement, duration, artist and album of every song.
The artist's country, followers, total plays, favourites, counts of songs, albums and videos, and the first 20 of each.
Current and all-time rank in Kenya and the Similar Artists list.
What fans write on the artist's page, every page.
A weekly chart report with the reach and ranking of each charting artist.
curl -X POST https://api.reefapi.com/boomplay/v1/chart \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"Nigeria","period":"weekly"}'{
"ok": true,
"data": { … },
"meta": {
"api": "boomplay",
"endpoint": "chart",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Boomplay field actually contains
Fields that read differently from how they look. Every row was measured against live Boomplay on 2026-11-19.
| Field | What it holds |
|---|---|
| country (parameter) | The market. Boomplay shows each country its own charts, trending lists, rankings and licensed catalogue: Davido ranked #62 now and #6 all time in Nigeria, #121 and #7 in the US, in the same minute. Default NG. |
| chart tracks: position / rank_change | position is the place on the chart (1-100); rank_change the movement since the previous edition (+3 up, -2 down, 0 unchanged, null for a new entry). Both equalled boomplay.com's chart page on 100 of 100 rows of the Nigeria weekly Top 100. |
| play_count (artist, album, playlist) | Boomplay's total plays as an exact integer (Burna Boy: 1,395,879,192). On search cards and song pages Boomplay prints a rounded figure; those come as play_count_printed ("1.3b", "14m") plus play_count_approx, the printed figure as an integer. |
| favorite_count / share_count / comment_count | The numbers on the item's own buttons. For 6 artists all 18 values equalled the artist page; for 6 songs the favourite and comment counts equalled the song page 12 of 12. `comments` returns the thread itself, whose `total` can be higher on artists (Burna Boy: 3,787 on the button, 3,900 in the thread). |
| similar_songs: *_snapshot | Counters stored with Boomplay's recommendations. They lag the live song (294,112 snapshot plays vs "2.8m" on the song page), so use `song` / `song_page` for current numbers. |
| has_lyrics / lyrics_info | Whether lyrics exist and whether they are time-synced, with the lyrics page link. The lyrics text itself is not returned. |
| available_countries (album) | The countries an album is licensed in, as Boomplay lists them on genre pages. |
| null counters on trending and genre lists | Boomplay sends 0 for favourites, shares and comments on most rows of its trending and genre lists while the song or album itself has them (a trending song listed with 0 favourites had 6,723). Those zeros come back as null; open the item for the real count. |
Song pages are licensed per country: a song that is not licensed in the chosen market returns NOT_FOUND saying so (Burna Boy "Love" in the US), and searches from that market show only what is licensed there (album search "afro": 12 results in Nigeria, 7 in the US).
Boomplay coverage, measured
Every number below was read from live Boomplay on 2026-11-19: 468 calls over 58 actions, plus checks that wrong inputs get the right error.
179 country codes. Nigeria: 40 weekly, 42 daily and 40 monthly charts of 100 songs, weekly top 100 artists and top 100 albums. Rankings, charts and trending lists differ by market (the top 100 artists of Nigeria and South Africa share 5 names).
Nigeria's weekly Top 100: position and movement equalled boomplay.com's chart page on 100 of 100 rows. Artist favourites, shares and comments equalled the artist page on 18 of 18 values (6 artists); song favourites and comments equalled the song page on 12 of 12 (6 songs). Ids from search opened the same item on 34 of 34 round trips.
Three consecutive pages repeated no row on 15 lists (song, user, video and artist search, comments, artist songs, rankings, artist and playlist directories, videos, Buzz, podcast episodes, podcasts, genres, recommendations). All 559 comments on one song came back over 28 pages; all 45 songs of one artist over 3 pages.
browse_artists: female 100 of 100 rows female, region Ghana 100 of 100 Ghanaian, letter B 100 of 100 starting with B, each list sharing at most 9 of 100 artists with the unfiltered list. Day, week and all-time rankings, video categories, podcast sort and trending tags each returned a different list.
Song play counts exist only as boomplay.com prints them, rounded ("14m"). Web search tabs return 12 per page. A playlist comes in one answer with all its tracks (200 on the largest chart), without paging. Top comments are one short list. Song lists leave out songs not licensed in the market, so a page of 20 can hold 19. Some markets have no trending podcasts (Ghana and Tanzania on 2026-11-19). The first search-tab, artist-page or song-page call in a market after a quiet spell answers "warming up — retry shortly" (HTTP 429, Retry-After 5) within 5.2 s; with all five markets started at once, retrying every 5 s was served after 18-94 s (median 45 s), then 150 of 150 calls answered with a median of 1.6-2.7 s. Lyrics text and audio are not returned.
What people build with Boomplay
The jobs this data is most often used for.
Track Top 100 charts across African countries, week by week, with movement.
Monitor an artist's followers, total plays and ranking in each market.
Find rising songs per genre and per country for A&R and playlisting.
Collect fan comments on songs, albums and artists for sentiment analysis.
endpoints
credits per call
What Boomplay data costs
The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/boomplay/v1/chart \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"region":"Nigeria","period":"weekly"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/boomplay/v1/chart",
headers={"x-api-key": REEF_KEY},
json={
"region": "Nigeria",
"period": "weekly"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Boomplay.
Which countries' charts can I get?▾
Every market Boomplay serves: 179 country codes. Nigeria has 40 weekly charts (Top 100 Nigeria, Africa, International, Christian & Gospel and one Top 100 for each other country Boomplay charts), 42 daily charts (including Top New Songs and Daily Rising) and 40 monthly charts. Pick one with `chart` by id or by region + period, e.g. region "Kenya", period "weekly".
Do I get play counts?▾
Exact total plays for artists, albums and playlists (Burna Boy: 1,395,879,192 on 2026-11-19). For a single song Boomplay only prints a rounded figure on the song page ("14m"); `song_page` returns it as printed and as an integer.
Can I see whether a song is rising on the chart?▾
Yes. Every chart row has its position and rank_change since the previous edition, exactly as boomplay.com shows the arrows. `trending_songs` gives the hot, new and per-genre trending lists (100 songs each) with movement too.
Can I get all comments on a song?▾
Yes. `comments` pages through every comment, up to 100 per page, with the total: all 559 comments on Burna Boy's "Love" came back over 28 pages of 20 with no repeats. Each comment has text, date, likes, reply count, the comment it answers, and the commenter's name, country and VIP status. sort=top returns Boomplay's short top-comments list.
How do I find an artist's id?▾
`search_artists` returns 12 artists per page with their Boomplay id and printed play count; `search_videos` also names the best-matching artist with exact plays; `suggest` autocompletes. Ids from any of them work in `artist`, and boomplay.com links work as well.
Are artist rankings available?▾
`artist_rankings` returns Boomplay's ranking of a market for the day, the week or all time, 100 artists. `similar_artists` returns one artist's current and all-time rank in a market.
Can I filter the artist directory?▾
`browse_artists` filters by genre, gender, region and first letter (female: 100 of 100 rows female; region Ghana: 100 of 100 Ghanaian), ordered by popularity with total plays and followers. `artist_filters` lists the values.
How fresh is the data?▾
Every call reads Boomplay live; nothing is cached except the short lists of genre, category and tag names.
What is the Boomplay API?▾
Boomplay API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /boomplay/v1.
Is the Boomplay API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Boomplay calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Boomplay login or account?▾
No login to Boomplay is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Boomplay data?▾
The page example is captured from a live search_songs call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Boomplay API use?▾
Boomplay actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Boomplay from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call boomplay actions with the same key, credit pool and JSON envelope used by normal REST requests.
43 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Boomplay, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.