Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/search/releases

Search releases

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/musicbrainz-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/musicbrainz-api/v1/search/releases" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/musicbrainz-api/v1/search/releases", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/musicbrainz-api/v1/search/releases");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/musicbrainz-api/v1/search/releases",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 6808,
        "query": "ok computer radiohead",
        "releases": [
            {
                "id": "4b3d18cc-8937-36f4-8de0-481088be58e6",
                "date": "1997-06-17",
                "media": [
                    {
                        "format": "CD",
                        "tracks": [],
                        "track_count": 12
                    }
                ],
                "score": 100,
                "title": "OK Computer",
                "artist": [
                    {
                        "id": "a74b1b7f-71a5-4011-9441-d0b5e4122711",
                        "name": "Radiohead"
                    }
                ],
                "status": "Official",
                "barcode": "724385522925",
                "country": "CA",
                "packaging": "Jewel Case",
                "label_info": [
                    {
                        "label": "EMI Music Canada",
                        "catalog_number": "7243 8 55229 2 5"
                    }
                ],
                "track_count": 12
            },
            {
                "id": "9c1e5e9e-9f40-4cd8-94a4-785fa5d0b613",
                "date": "1997",
                "media": [
                    {
                        "format": "Cassette",
                        "tracks": [],
                        "track_count": 12
                    }
                ],
                "score": 100,
                "title": "OK Computer",
                "artist": [
                    {
                        "id": "a74b1b7f-71a5-4011-9441-d0b5e4122711",
                        "name": "Radiohead"
                    }
                ],
                "status": "Official",
                "barcode": "724385522949",
                "country": "PL",
                "packaging": "Cassette Case",
                "label_info": [
                    {
                        "label": "Parlophone",
                        "catalog_number": "7243 8 55229 4 9"
                    }
                ],
                "track_count": 12
            },
            {
                "id": "541a0976-ca45-3c0f-89e5-26bc376f58d1",
                "date": "1997-06-16",
                "media": [
                    {
                        "format": "12\" Vinyl",
                        "tracks": [],
                        "track_count": 6
                    },
                    {
                        "format": "12\" Vinyl",
                        "tracks": [],
                        "track_count": 6
                    }
                ],
                "score": 100,
                "title": "OK Computer",
                "artist": [
                    {
                        "id": "a74b1b7f-71a5-4011-9441-d0b5e4122711",
                        "name": "Radiohead"
                    }
                ],
                "status": "Official",
                "barcode": "724385522918",
             
…