Get Album Metadata from Providers (Advanced)
POST
/api/metadata/search/albums
const url = 'https://example.com/api/metadata/search/albums';const options = { method: 'POST', headers: { cookie: 'ms.session_token=<ms.session_token>', 'Content-Type': 'application/json' }, body: '{"artists":[{"name":"example","metadata":[{"name":"musicbrainz","id":"example","idType":"recording"}]}],"album":{"name":"example","metadata":[{"name":"musicbrainz","id":"example","idType":"recording"}]}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/metadata/search/albums \ --header 'Content-Type: application/json' \ --cookie ms.session_token=<ms.session_token> \ --data '{ "artists": [ { "name": "example", "metadata": [ { "name": "musicbrainz", "id": "example", "idType": "recording" } ] } ], "album": { "name": "example", "metadata": [ { "name": "musicbrainz", "id": "example", "idType": "recording" } ] } }'Gets album results from all metadata providers using Credits with metadata. Send the header Accept: application/x-ndjson to get results as newline-delimited JSON, one line per provider as soon as it finishes: {"type":"result","service":"...","data":[...]} or {"type":"error","service":"...","error":{...}}, followed by a final {"type":"done"} line.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
artists
Responses
Section titled “Responses”Success
The request failed validation
Media typeapplication/json
The request’s body, query or params didn’t match the route’s schema
object
error
required
string
details
required
What was wrong, one entry per problem
Array<object>
object
message
required
string
path
Where the problem is, e.g. [“amount”] or [“items”, 0, “id”]
Array
Example
{ "error": "Validation failed"}