Discovery
Browse
The three feeds behind Spotify's own home screen — editorial categories, featured playlists and new releases — each of them geo-aware. Switch the country and the same call returns a different shelf.
GET /browse/categories?country=US&locale=en_US&limit=50
No categories
Spotify returned no editorial categories for United States.
About the Browse endpoints
Browse is the discovery half of the API: curated shelves rather than query results. Every endpoint takes country and locale, and both genuinely change what comes back — the same call to Japan and Argentina returns different playlists.
All three support limit (max 50) and offset for pagination.
Homepage widgets
Embed featured playlists and category tiles on a publisher home page.
New-release digests
Poll /browse/new-releases each morning for a curated email.
Regional discovery
Surface country-specific shelves from one country parameter.
Trending apps
Build a 'what is hot today' feed that refreshes hourly.
Music journalism
Auto-populate release calendars with structured album metadata.
Friday drop reports
Generate New Music Friday roundups per genre or region.
FAQ
How is Browse different from Search?
Browse returns curated shelves for discovery; Search returns results for a typed query. Use Browse on a home screen, Search behind a field.
Why do countries return different playlists?
Spotify regionalizes its editorial content. Same endpoint, different country code, different shelf — which is exactly what makes localizing an app cheap.
Can I paginate?
Yes — limit (default 20, max 50) and offset on every Browse endpoint.
What is a category?
A genre or mood bucket — Pop, Workout, Focus — curated by Spotify's editorial teams.
Does /browse/categories/{id} return that category's playlists?
No. It returns the category record itself: id, name and icon. There is no category-playlists route on this API, so a drilldown that promises playlists is promising something it cannot deliver.
How fresh are new releases?
Updated several times a day. New Music Friday drops appear within minutes of release.
Ship a discovery feature
Unlimited Browse access on whichever platform fits your billing.