Integrate the Hoopr music catalog in an afternoon.
A clean, OAuth2-secured REST API to browse, search and stream licensed music. One base URL, test & live modes, predictable JSON. Built for product and engineering teams.
- 1 hr
- token lifetime
- 600/min
- rate limit
- 5 langs
- code samples
# 1) Get a token
TOKEN=$(curl -s -X POST https://<your-b2b-host>/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"grant_type":"client_credentials","client_id":"<id>","client_secret":"<secret>"}' \
| jq -r '.data.access_token')
# 2) Browse the catalog
curl "https://<your-b2b-host>/v1/tracks?type=music&filterSlugs=electronic" \
-H "Authorization: Bearer $TOKEN"Everything you need
A catalog API designed for production
Authentication, search, playlists and rate limits — the same primitives you already know from Stripe and Razorpay, applied to music.
OAuth2 client credentials
Exchange a client_id / client_secret for a short-lived Bearer token. Scopes gate every endpoint.
Test & live modes
One base URL. The secret you authenticate with decides the mode — just like Stripe and Razorpay.
Powerful search
Free-text plus structured filters by genre, mood, BPM, vocals and use-case — as query params or a JSON body.
Playlists
Access curated and custom playlists, page through their tracks, with per-client access control.
Filter master list
One call returns every genre, mood and use-case to power your search UIs and dropdowns.
Signed stream URLs
Each track ships a 30-minute signed stream URL plus cacheable artwork — ready to drop into a player.
Popularity analytics
Surface the most-licensed tracks across the catalog with a dedicated analytics scope.
Predictable rate limits
Generous per-client limits with standard RateLimit-* headers and clear 429 semantics.
Roadmap: webhooks & more
Delta exports, usage reporting, waveforms, recommendations and stems — enable what fits your build.
How it works
Three calls from zero to streaming
1 · Authenticate
POST your client_id + client_secret to /v1/auth/token. Receive a 1-hour Bearer access token.
2 · Call the API
Send the token as Authorization: Bearer on every catalog request. The token's mode (test/live) is bound to the secret used.
3 · Get music
Browse, search, and fetch tracks, playlists & filters. Stream via short-lived signed URLs.
API reference
Nine endpoints. One envelope.
Every response shares the same { data, error } shape, so error handling is identical everywhere.
Ready to integrate the catalog?
Get sandbox credentials, walk through your use case, and ship. Our team will help you scope scopes, playlists and rate limits.