Albums · GET

Album metadata

GET /album_metadata

About

Album metadata is a GET endpoint in the Albums group of the Spotify Data API. It takes 2 parameters: id (required), plus contrast (optional). No recorded sample exists for it; press Run to fetch a live response.

Parameters 2

id Required
In
query
Default
—
contrast Optional
In
query
Default
—
Description
Comma-separated list of streaming providers to contrast against. Appends a `_contrast` field to the response with cross-platform matching data. Available providers: `ytmusic`, `applemusic`, `amazonmusic`, `tencentmusic`, `pandora`, `gaana`.

Request

Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends.

Sample response

Live only

This endpoint has no recorded sample. Press Run to fetch a real response.

Errors

400
“id” is required — a request that omits it, or sends a value of the wrong type, is rejected before it reaches Spotify.
404
No Spotify item exists for the “id” that was sent. Spotify ids are 22 characters of base62, so a share link has to be reduced to the id in it first.
401 / 403
The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
429
Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
5xx
Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.

Related endpoints

The other 2 operations in the Albums group.