Reef AI: ask for any data. Try it
Boomplay API

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
58 active endpoints, on 0, 1 and 2 credit tiers.+48 more, every parameter ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run 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

View docs ↗

A country's Top 100 with position and movement

2 credits0 required · 2 optional
POST/boomplay/v1/chart
idle
// 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.

Try every endpoint in the playground

Endpoints

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 cr

    Search Boomplay songs by text in one market.

    required
    query
    optional
    page, per_page, country
  • search_videos

    1 cr

    Search Boomplay videos (music videos, interviews, documentaries, live shows…) by text, plus t…

    required
    query
    optional
    page, per_page, country
  • search_users

    1 cr

    Search Boomplay user profiles by name.

    required
    query
    optional
    page, per_page, country
  • suggest

    1 cr

    Autocomplete.

    required
    query
    optional
    country
  • search_artists

    2 cr

    Search artists by name on boomplay.com's Artists tab.

    required
    query
    optional
    page, country
  • search_albums

    2 cr

    Search albums by title on boomplay.com's Albums tab.

    required
    query
    optional
    page, country
  • search_playlists

    2 cr

    Search playlists by title on boomplay.com's Playlists tab.

    required
    query
    optional
    page, country
  • search_podcasts

    2 cr

    Search podcasts (shows) and podcast episodes on boomplay.com's Podcasts tab.

    required
    query
    optional
    page, country
  • song

    2 cr

    One song.

    required
    song
    optional
    country
  • lyrics_info

    1 cr

    Whether a song has lyrics on Boomplay, whether they are time-synced (karaoke-style), their re…

    required
    song
    optional
    country
  • song_page

    2 cr

    What a song's boomplay.com page prints.

    required
    song
    optional
    country
  • similar_songs

    1 cr

    Songs similar to a song.

    required
    song
    optional
    country
  • song_playlists

    1 cr

    Public playlists that contain a song (one list, up to 45 measured.

    required
    song
    optional
    country
  • artist

    1 cr

    One artist.

    required
    artist
    optional
    country
  • artist_songs

    1 cr

    Every song of an artist, 20 per page (the source's fixed page size), newest first.

    required
    artist
    optional
    page, country
  • artist_albums

    1 cr

    Every album / single / EP of an artist with play and favourite counts, 20 per page.

    required
    artist
    optional
    page, country
  • artist_videos

    1 cr

    Every video of an artist with view, favourite, comment, share and download counts, 20 per page.

    required
    artist
    optional
    page, country
  • similar_artists

    2 cr

    An artist's boomplay.com page.

    required
    artist
    optional
    country
  • artist_playlists

    2 cr

    Playlists shown on an artist's boomplay.com page, with the page's total playlist count.

    required
    artist
    optional
    country
  • artist_rankings

    1 cr

    Boomplay's artist ranking in a market for the day, the week or all time.

    required
    —
    optional
    period, page, per_page, country
  • browse_artists

    1 cr

    Browse 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 cr

    The filter values browse_artists accepts.

    required
    —
    optional
    country
  • album

    1 cr

    One album / single / EP with every track.

    required
    album
    optional
    country
  • album_recommendations

    1 cr

    Albums / playlists Boomplay recommends next to an album.

    required
    album
    optional
    page, per_page, country
  • playlist

    1 cr

    One playlist with ALL its tracks in one answer (200 measured on a 200-song chart), owner (nam…

    required
    playlist
    optional
    country
  • playlist_recommendations

    1 cr

    Playlists Boomplay recommends next to a playlist.

    required
    playlist
    optional
    page, per_page, country
  • browse_playlists

    1 cr

    Browse Boomplay's playlist directory by genre, ordered by popularity, with play counts and ow…

    required
    —
    optional
    genre, page, per_page, country
  • playlist_genres

    0 cr

    Genre ids browse_playlists accepts.

    required
    —
    optional
    country
  • charts

    1 cr

    Every chart shelf of a market.

    required
    —
    optional
    country
  • chart_list

    1 cr

    All chart playlists of one period (weekly.

    required
    —
    optional
    period, country
  • chart

    2 cr

    One chart with its ranked songs (Top 100).

    required
    —
    optional
    chart, region, period, country
  • top_artists

    1 cr

    The market's weekly top artists chart (100 artists) in rank order, with images.

    required
    —
    optional
    country
  • top_albums

    1 cr

    The market's weekly top albums chart (100 albums) with rank, artist and release year.

    required
    —
    optional
    country
  • trending

    1 cr

    Every trending shelf of a market.

    required
    —
    optional
    country
  • trending_songs

    1 cr

    A market's trending songs (100).

    required
    —
    optional
    tag, country
  • trending_tags

    0 cr

    The tags trending_songs accepts (hot, new, and 25 genres).

    required
    —
    optional
    country
  • home

    1 cr

    The Boomplay app's home page for a market.

    required
    —
    optional
    country
  • home_section

    1 cr

    One home shelf in full by its id (from home).

    required
    section
    optional
    country
  • popular_songs

    1 cr

    The 50 songs most searched / played from search in a market, ranked, with movement.

    required
    —
    optional
    country
  • popular_artists

    1 cr

    The 50 artists most popular on search in a market, ranked, with movement.

    required
    —
    optional
    country
  • trending_searches

    2 cr

    The search keywords Boomplay promotes in a market (search-bar shortcuts and hot keywords).

    required
    —
    optional
    country
  • genres

    0 cr

    Boomplay's music genres (id, name, images).

    required
    —
    optional
    country
  • genre

    1 cr

    One genre.

    required
    genre
    optional
    page, per_page, country
  • video

    1 cr

    One video.

    required
    video
    optional
    country
  • videos

    1 cr

    Videos of one category, newest first, up to 50 per page.

    required
    —
    optional
    category, page, per_page, country
  • video_categories

    0 cr

    The video categories videos accepts.

    required
    —
    optional
    country
  • podcast

    1 cr

    One podcast (show).

    required
    podcast
    optional
    country
  • podcast_episodes

    1 cr

    Every episode of a podcast, newest first, up to 100 per page.

    required
    podcast
    optional
    page, per_page, country
  • episode

    1 cr

    One podcast episode with its show, author, duration, date and counts.

    required
    episode
    optional
    country
  • browse_podcasts

    1 cr

    Podcasts by category, most popular or newest first, up to 50 per page.

    required
    —
    optional
    category, sort, page, per_page, country
  • browse_episodes

    1 cr

    Podcast episodes by category, most popular or newest first, up to 50 per page.

    required
    —
    optional
    category, sort, page, per_page, country
  • podcast_home

    1 cr

    The podcast home of a market.

    required
    —
    optional
    country
  • podcast_trending

    2 cr

    Trending podcasts and trending episodes of a market.

    required
    —
    optional
    country
  • podcast_categories

    0 cr

    Podcast categories (ids for browse_podcasts).

    required
    —
    optional
    country
  • buzz_posts

    1 cr

    Boomplay Buzz.

    required
    —
    optional
    page, per_page, country
  • buzz_post

    1 cr

    One Buzz post in full.

    required
    post
    optional
    country
  • comments

    1 cr

    Comments on a song, album, artist, playlist, video, podcast, episode or Buzz post.

    required
    type, id
    optional
    sort, page, per_page, country
  • user

    1 cr

    A 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 it works

How the Boomplay API works

Boomplay is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /boomplay/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
0 or 1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a country's chart to the artists behind it

Read a market's weekly Top 100, then open the artists and their audience.

01chart?region=Kenya&period=weekly&country=KE
GET/boomplay/v1/chart?region=Kenya&period=weekly&country=KE

Top 100 Kenya: position, movement, duration, artist and album of every song.

02artist?artist=996269&country=KE
GET/boomplay/v1/artist?artist=996269&country=KE

The artist's country, followers, total plays, favourites, counts of songs, albums and videos, and the first 20 of each.

03similar_artists?artist=996269&country=KE
GET/boomplay/v1/similar_artists?artist=996269&country=KE

Current and all-time rank in Kenya and the Similar Artists list.

04comments?type=artist&id=996269
GET/boomplay/v1/comments?type=artist&id=996269

What fans write on the artist's page, every page.

A weekly chart report with the reach and ranking of each charting artist.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "boomplay",
    "endpoint": "chart",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat 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_changeposition 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_countThe 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: *_snapshotCounters 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_infoWhether 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 listsBoomplay 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).

Coverage

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.

Markets

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).

Checks

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.

Paging

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.

Filters

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.

Limits

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.

Use cases

What people build with Boomplay

The jobs this data is most often used for.

01

Track Top 100 charts across African countries, week by week, with movement.

02

Monitor an artist's followers, total plays and ranking in each market.

03

Find rising songs per genre and per country for A&R and playlisting.

04

Collect fan comments on songs, albums and artists for sentiment analysis.

58

endpoints

0/1/2

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.