Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Boomplay API page →
docs / boomplay

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.

base /boomplay/v158 endpoints
post/boomplay/v1/search_songs1 credit

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

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
per_page = 20optional1–100Rows per page, 20 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/search_videos1 credit

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

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/search_users1 credit

Search Boomplay user profiles by name. Paging: 20 per page, up to 100.

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
per_page = 20optional1–100Rows per page, 20 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/suggest1 credit

Autocomplete: what Boomplay suggests while you type (artists, songs, albums, playlists…), 20 suggestions per query.

ParameterAllowed / rangeDescription
queryrequired—Search text.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/search_artists2 credits

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

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/search_albums2 credits

Search albums by title on boomplay.com's Albums tab: 12 per page, real paging. Pass the web id to `album` for every track.

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/search_playlists2 credits

Search playlists by title on boomplay.com's Playlists tab: 12 per page, real paging.

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/search_podcasts2 credits

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

ParameterAllowed / rangeDescription
queryrequired—Search text.
page = 1optional1–5001-based page number.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/song2 credits

One 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`.

ParameterAllowed / rangeDescription
songrequired—Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/lyrics_info1 credit

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

ParameterAllowed / rangeDescription
songrequired—Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/song_page2 credits

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

ParameterAllowed / rangeDescription
songrequired—Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/similar_songs1 credit

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

ParameterAllowed / rangeDescription
songrequired—Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/song_playlists1 credit

Public playlists that contain a song (one list, up to 45 measured; the source does not page it).

ParameterAllowed / rangeDescription
songrequired—Boomplay song id: the numeric id or the EQ… web id, or a boomplay.com/songs/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/artist1 credit

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/artist_songs1 credit

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
page = 1optional1–5001-based page number.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/artist_albums1 credit

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
page = 1optional1–5001-based page number.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/artist_videos1 credit

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
page = 1optional1–5001-based page number.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/similar_artists2 credits

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/artist_playlists2 credits

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

ParameterAllowed / rangeDescription
artistrequired—Boomplay artist id: the numeric id or the EQ… web id, or a boomplay.com/artists/… link.
country = NGoptionalNG · GH · KE · ZA · USMarket 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.
Try in playground →
post/boomplay/v1/artist_rankings1 credit

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

ParameterAllowed / rangeDescription
period = weekoptionalday · week · all_timeRanking period.
page = 1optional1–5001-based page number.
per_page = 50optional1–100Rows per page, 50 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/browse_artists1 credit

Browse 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`.

ParameterAllowed / rangeDescription
genreoptional—Genre id from `artist_filters` (0 / empty = all).
gender = alloptionalall · male · female · groupArtist gender.
region = alloptionalall · nigeria · kenya · tanzania · ghana · europe_north_america · otherArtist region.
letteroptional—First letter A-Z, or '#' for others.
page = 1optional1–5001-based page number.
per_page = 50optional1–100Rows per page, 50 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/artist_filtersfree

The filter values `browse_artists` accepts: genres (id + name), genders, regions, letters.

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/album1 credit

One album / single / EP with every track: type, release year, artist, play / favourite / share / comment / download counts, description.

ParameterAllowed / rangeDescription
albumrequired—Boomplay album id: the numeric id or the EQ… web id, or a boomplay.com/albums/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/album_recommendations1 credit

Albums / playlists Boomplay recommends next to an album. Up to 50 per page, real paging.

ParameterAllowed / rangeDescription
albumrequired—Boomplay album id: the numeric id or the EQ… web id, or a boomplay.com/albums/… link.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/playlist1 credit

One 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`.

ParameterAllowed / rangeDescription
playlistrequired—Boomplay playlist id: the numeric id or the EQ… web id, or a boomplay.com/playlists/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/playlist_recommendations1 credit

Playlists Boomplay recommends next to a playlist. Up to 50 per page, real paging.

ParameterAllowed / rangeDescription
playlistrequired—Boomplay playlist id: the numeric id or the EQ… web id, or a boomplay.com/playlists/… link.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/browse_playlists1 credit

Browse Boomplay's playlist directory by genre, ordered by popularity, with play counts and owners. Up to 50 per page. Genre ids: `playlist_genres`.

ParameterAllowed / rangeDescription
genreoptional—Genre id from `playlist_genres` (0 / empty = all).
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/playlist_genresfree

Genre ids `browse_playlists` accepts.

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/charts1 credit

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

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/chart_list1 credit

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

ParameterAllowed / rangeDescription
period = weeklyoptionalweekly · daily · monthlyChart period.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/chart2 credits

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

ParameterAllowed / rangeDescription
chartoptional—Chart playlist id / web id / link (from `chart_list`).
regionoptional—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 = weeklyoptionalweekly · daily · monthlyChart period when picking by region.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/top_artists1 credit

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

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/top_albums1 credit

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

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/home1 credit

The Boomplay app's home page for a market: every shelf with its items.

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/home_section1 credit

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

ParameterAllowed / rangeDescription
sectionrequired—Shelf id from `home`.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/genresfree

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

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/genre1 credit

One genre: its top artists (total plays), albums (plays, availability by country) and playlists (plays, owner), paged together, up to 50 per page.

ParameterAllowed / rangeDescription
genrerequired—Genre id from `genres`.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/video1 credit

One video: title, category, artist, duration, description, view / favourite / comment / share / download counts.

ParameterAllowed / rangeDescription
videorequired—Boomplay video id: the numeric id or the EQ… web id, or a boomplay.com/video/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/videos1 credit

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

ParameterAllowed / rangeDescription
category = music_videosoptionalmusic_videos · interviews · documentaries · talk_shows · comedy · concertsVideo category.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/video_categoriesfree

The video categories `videos` accepts.

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/podcast1 credit

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

ParameterAllowed / rangeDescription
podcastrequired—Boomplay podcast id (digits), or a boomplay.com/podcasts/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/podcast_episodes1 credit

Every episode of a podcast, newest first, up to 100 per page; `total` = the show's episode count.

ParameterAllowed / rangeDescription
podcastrequired—Boomplay podcast id (digits), or a boomplay.com/podcasts/… link.
page = 1optional1–5001-based page number.
per_page = 20optional1–100Rows per page, 20 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/episode1 credit

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

ParameterAllowed / rangeDescription
episoderequired—Boomplay episode id (digits), or a boomplay.com/episode/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/browse_podcasts1 credit

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

ParameterAllowed / rangeDescription
category = 0optional—Category id from `podcast_categories` (0 = all).
sort = popularoptionalpopular · newOrder.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/browse_episodes1 credit

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

ParameterAllowed / rangeDescription
category = 0optional—Category id from `podcast_categories` (0 = all).
sort = popularoptionalpopular · newOrder.
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/podcast_home1 credit

The podcast home of a market: every shelf of podcasts and episodes.

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/podcast_categoriesfree

Podcast categories (ids for browse_podcasts).

ParameterAllowed / rangeDescription
country = NGoptional—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.
Try in playground →
post/boomplay/v1/buzz_posts1 credit

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

ParameterAllowed / rangeDescription
page = 1optional1–5001-based page number.
per_page = 20optional1–50Rows per page, 20 by default, at most 50.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/buzz_post1 credit

One Buzz post in full: text, author, tag, media, the linked item and its view / favourite / share / comment counts.

ParameterAllowed / rangeDescription
postrequired—Boomplay post id (digits), or a boomplay.com/buzz/… link.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/comments1 credit

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

ParameterAllowed / rangeDescription
typerequiredsong · album · artist · playlist · video · podcast · episode · postWhat the id points to.
idrequired—The item's id, EQ… web id or boomplay.com link.
sort = newestoptionalnewest · topnewest (default) or top.
page = 1optional1–5001-based page number.
per_page = 20optional1–100Rows per page, 20 by default, at most 100.
country = NGoptional—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.
Try in playground →
post/boomplay/v1/user1 credit

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

ParameterAllowed / rangeDescription
userrequired—Boomplay user id (digits), or a boomplay.com/users/… link.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.