Skip to content

Get Album Metadata from Providers

GET
/api/metadata/search/albums
curl --request GET \
--url 'https://example.com/api/metadata/search/albums?album=example' \
--cookie ms.session_token=<ms.session_token>

Gets album results from all metadata providers. 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.

album
required
Any of:
string
/^(rid|rgid|mbid|spotify):[\s\S]{0,}$/
artists

A list of plain artist strings associated with the album

Array<string>

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
Allowed value: Validation failed
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"
}