Skip to main content
MusicAPI
Boomplay integration · live

Boomplay API access, without the Boomplay integration

A single REST interface for Boomplay auth, catalogue search, listener libraries and playlist writes — sharing the exact request and response shape as 11 other music services. No Boomplay developer account, no OAuth client, no token storage on your side: we hold the Boomplay credentials and use them only to move a listener's own library on their behalf, the way FreeYourMusic has for ten years.

1
redirect to authenticate a listener
12
services on the same schema
0
Boomplay dev accounts you manage
auth · boomplay
# 1 — send the listener to the hosted Boomplay authorisation page.
# Your account slug: you · returnUrl whitelisted in the dashboard.
https://app.musicapi.com/you/boomplay/auth
?returnUrl=https://you.example/connected
# 2 — they come back to returnUrl with ?data64=<base64>:
{
"integrationUserUUID": "6a002d4b-f95b-471f-a27d-609a42e10cdb",
"authModel": { "status": "success", "error": null },
"integration": { "type": "boomplay" }
}
# 3 — that UUID unlocks every Boomplay user endpoint:
GET https://api.musicapi.com/api/6a002d4b-f95b-471f-a27d-609a42e10cdb/playlists
Authorization: Basic <clientId:clientSecret>
What you can do

Everything the Boomplay API exposes, on one schema.

01AVAILABLE
Read the library
Full paged access to liked tracks, albums in Boomplay.
02AVAILABLE
Read playlists
Owned and followed playlists with track order, artwork and descriptions intact.
03AVAILABLE
Write playlists
Create, append and reorder playlists in a listener's Boomplay account, idempotently.
04AVAILABLE
Search & match
Resolve any track, album or artist to its Boomplay ID, by ISRC or by text, with a confidence score.
05AVAILABLE
Catalogue metadata
Tracks, albums, artists and artwork from the public Boomplay catalogue, no listener auth needed.
06AVAILABLE
Cross-service IDs
Resolve one recording to its ID on Boomplay and the other 11 services at once.
07AVAILABLE
Listener profile
Display name, avatar, country and account tier, in one normalised shape.
08AVAILABLE
Raw passthrough
Need a Boomplay field we don't normalise in your transfer flow? Request the underlying token for that listener.
page size: 50search by ISRC: yesreturns ISRC: yesedit playlist details: yesreturns listener country: no
Endpoints

Same routes for boomplay as for the other 11.

Swap the musicService value and every call below behaves identically. Public catalogue routes need no listener auth; user routes are addressed by the userUUID returned from the auth callback.

Boomplay specifics
Strong African catalogue coverage, including releases with no ISRC — matched on artist plus normalised title.
Compared to the official API

What you'd otherwise build against Boomplay directly.

The official Boomplay API is free. The work around it — approval, quota, auth, pagination quirks, breaking changes — is what teams actually pay for, once per service.

Concern
Direct Boomplay API
MusicAPI
Getting access
Developer account, app review, quota requests per service
One key, all 12 services, live in minutes
Authentication
Your own OAuth client, redirect URIs, token storage and refresh
One hosted redirect; we hold clients and refresh tokens, used only for the transfers listeners authorise
Response shapes
Every provider models tracks, albums and playlists differently
One normalised schema across all 12
Breaking changes
You track 12 changelogs and ship fixes
We absorb them behind a versioned interface
Rate limits
Per-provider ceilings, backoff and retry logic on you
Standardised 429s with Retry-After, retries and idempotency built in
Adding a service
A new integration project each time, after Boomplay
Change one string in the request
FAQ

Boomplay API questions we get weekly.

Do I need my own Boomplay developer account?

No. Boomplay has no public developer program. MusicAPI is the only self-serve way to read a listener’s Boomplay library. MusicAPI holds the Boomplay credentials and uses them solely to facilitate music transfers a listener has authorised, the same model FreeYourMusic has run for ten years. You call one API with your own key; we handle the Boomplay side, including token refresh and revocation.

Is this a wrapper around the official Boomplay API?

It's a transfer layer, not a general-purpose proxy. Requests hit our infrastructure, which speaks each provider's API on the listener's behalf to move their library and returns one consistent schema — plus matching, pooled quota and retries you'd otherwise write yourself.

Can I still get the raw Boomplay response?

Yes, for the listeners who authorised a transfer. Passthrough gives you that listener's underlying Boomplay token when your transfer flow needs a field we don't normalise.

What does it cost?

Billed per request to a music service, in buckets: €0.60 per 1,000 for the first 5M, €0.45 up to 25M, €0.30 above that, with a €500 per month minimum.

How long does a Boomplay integration take?

A sandbox key is instant and reading a live library takes about an hour. Production integrations typically land in two to four engineering weeks — and adding the next 11 services after that is a string change.

Start with Boomplay today.

Sandbox keys are free and instant. Authenticate a real Boomplay account and make your first live call within the hour.

No card. Sandbox: 5 test listeners across services, e.g. 3 Boomplay + 2 Spotify.