Skip to content
GET /v1/search/release-groups

Search albums

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/release-groups" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/musicbrainz-api/v1/search/release-groups", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/musicbrainz-api/v1/search/release-groups");
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/release-groups",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "count": 3462,
        "query": "ok computer",
        "release_groups": [
            {
                "id": "a5e4bd1a-63c9-4dfc-9e63-ed0c3dc049be",
                "score": 100,
                "title": "Ok Computer",
                "artist": [
                    {
                        "id": "7bc012a7-c5cc-4e7a-9ca6-15db02bbcde4",
                        "name": "Lemaitre"
                    },
                    {
                        "id": "481ae6c0-d3cc-4ae7-9995-5850fbf15479",
                        "name": "RebMoe"
                    }
                ],
                "primary_type": "Single",
                "first_release_date": "2021-08-20"
            },
            {
                "id": "b1392450-e666-3926-a536-22c65f834433",
                "score": 100,
                "title": "OK Computer",
                "artist": [
                    {
                        "id": "a74b1b7f-71a5-4011-9441-d0b5e4122711",
                        "name": "Radiohead"
                    }
                ],
                "primary_type": "Album",
                "first_release_date": "1997-05-21"
            },
            {
                "id": "3b55129d-276c-4c42-8327-e47ba94f2ddf",
                "score": 78,
                "title": "OK Computer (8-bit)",
                "artist": [
                    {
                        "id": "318d1a3b-7323-4b59-8e7f-e16ddf8acacc",
                        "name": "Quinton Sung"
                    }
                ],
                "primary_type": "Album",
                "secondary_types": [
                    "Remix"
                ],
                "first_release_date": "2012-04-11"
            },
            {
                "id": "8cf63c7f-3d59-4b97-900c-ccd78445a766",
                "score": 78,
                "title": "OK Computer Part 2",
                "artist": [
                    {
                        "id": "e2638eb1-1b9b-4e16-8607-e5d934745d4c",
                        "name": "ShitLips"
                    }
                ],
                "primary_type": "Album",
                "first_release_date": "2018-07-06"
            },
            {
                "id": "0023289d-6560-4732-8dbc-d232ed5f5950",
                "score": 78,
                "title": "Ok Computer Però Trap",
                "artist": [
                    {
                        "id": "3cdfe413-413a-4ae3-913e-a6923db5c315",
                        "name": "Pippo Sowlo"
                    }
                ],
                "primary_type": "EP",
                "first_release_date": "2019-06-14"
            },
            {
                "id": "6c5a2f5b-8959-4e8e-8342-78b3e9ff72ce",
                "score": 78,
                "title": "Alexa Play OK Computer",
                "artist": [
                    {
                        "id": "89148a39-cb43-4115-b493-b5c1058b6e0e",
                        "name": "Us3r"
                    }
           
…