# TheAudioDB Music API
> A music encyclopedia as an API, powered by TheAudioDB — clean JSON, no key. Search artists and open any artist for their full profile: formed year, country, genre, style and mood, biography, record label, website and social links, and high-resolution images (thumb, logo, banner and fan art). Pull an artist's albums and their music videos, open an album for its description and details and list its tracks, and see what is trending now. Live data straight from TheAudioDB community database. Distinct from streaming and metadata APIs: this is the fan-facing music encyclopedia — biographies, artwork and music videos — ideal for music apps, artist pages, media galleries and Discord bots. 7 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/audiodb-api/..."
```

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 5 req/s
- **Starter** ($6/Mo) — 52,000 calls/Mo, 15 req/s
- **Pro** ($25/Mo) — 270,000 calls/Mo, 30 req/s
- **Mega** ($82/Mo) — 1,100,000 calls/Mo, 80 req/s

## Endpoints

### Artists

#### `GET /v1/artist` — Artist detail

**Parameters:**
- `id` (query, required, string) — Artist id Example: `111239`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/artist?id=111239"
```

**Response:**
```json
{
    "data": {
        "artist": {
            "id": "111239",
            "logo": "https://r2.theaudiodb.com/images/media/artist/logo/q094e21667518717.png",
            "mood": "Happy",
            "name": "Coldplay",
            "genre": "Alternative Rock",
            "label": "Parlophone",
            "mb_id": "cc197bad-dc9c-440d-a5b5-d52ba2e14234",
            "style": "Rock/Pop",
            "thumb": "https://r2.theaudiodb.com/images/media/artist/thumb/uxrqxy1347913147.jpg",
            "banner": "https://r2.theaudiodb.com/images/media/artist/banner/xuypqw1386331010.jpg",
            "fanart": "https://r2.theaudiodb.com/images/media/artist/fanart/spvryu1347980801.jpg",
            "gender": "Male",
            "country": "London, England",
            "members": 4,
            "twitter": "1",
            "website": "",
            "facebook": "",
            "alternate": "",
            "biography": null,
            "born_year": 1996,
            "disbanded": null,
            "formed_year": 1996
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:06.258Z",
        "request_id": "3a6ff7c9-4fae-419b-9715-9e55f642be28"
    },
    "status": "ok",
    "message": "Artist retrieved successfully",
    "success": true
}
```

#### `GET /v1/artist/albums` — An artist's albums

**Parameters:**
- `id` (query, required, string) — Artist id Example: `111239`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/artist/albums?id=111239"
```

**Response:**
```json
{
    "data": {
        "count": 51,
        "albums": [
            {
                "id": "2109614",
                "mood": "Relaxed",
                "name": "A Rush of Blood to the Head",
                "year": 2002,
                "cdart": "https://r2.theaudiodb.com/images/media/album/cdart/vuyruy1429191547.png",
                "genre": "Pop-Rock",
                "label": "Parlophone",
                "mb_id": "120c786d-a3b2-3c19-b4ff-2b7b3b4435bf",
                "score": 8.4,
                "style": "Rock/Pop",
                "thumb": "https://r2.theaudiodb.com/images/media/album/thumb/vsusvs1521243711.jpg",
                "artist": "Coldplay",
                "artist_id": "111239",
                "description": null
            },
            {
                "id": "2109615",
                "mood": "Relaxed",
                "name": "Parachutes",
                "year": 2000,
                "cdart": "https://r2.theaudiodb.com/images/media/album/cdart/vtuxpp1429197083.png",
                "genre": "Pop-Rock",
                "label": "Parlophone",
                "mb_id": "1dc4c347-a1db-32aa-b14f-bc9cc507b843",
                "score": 8.4,
                "style": "Rock/Pop",
                "thumb": "https://r2.theaudiodb.com/images/media/album/thumb/swxywp1367234202.jpg",
                "artist": "Coldplay",
                "artist_id": "111239",
                "description": null
            },
            {
                "id": "2109616",
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/artist/videos` — An artist's music videos

**Parameters:**
- `id` (query, required, string) — Artist id Example: `111239`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/artist/videos?id=111239"
```

**Response:**
```json
{
    "data": {
        "count": 60,
        "videos": [
            {
                "thumb": "https://r2.theaudiodb.com/images/media/track/thumb/xtqyxy1340357946.jpg",
                "track": "Princess of China",
                "track_id": "32724200",
                "description": "\"Princess of China\" is a song by British alternative rock band Coldplay with guest vocals by Barbadian recording artist Rihanna. It is the tenth track from Coldplay's fifth studio album Mylo Xyloto (2011). \"Princess of China\" was written by band members Guy Berryman, Jonny Buckland, Will Champion, and Chris Martin, along with Brian Eno, and draws influences from the music genres of electronic rock, electropop and R&B. The song released to US mainstream radio on 14 February 2012. It was released as a digital download worldwide on 13 April 2012. A remixes EP was released worldwide on 1 June 2012. It was released in the UK on 4 June 2012.\n\nThe song was met with a generally favorable response from music critics, with some praising the collaboration between Martin and Rihanna, though others criticized it for being uninspiring. \"Princess of China\" has performed well on international charts around the world, and has so far peaked at number 20 on the US Billboard Hot 100 and number four on the UK Singles Chart. It has also reached the top ten of the Australian and New Zealand charts.\n\nThe song's accompanying music video, directed by Adria Petty and Alan Bibby, was filmed on 22 March and 23 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/artists` — Search artists

**Parameters:**
- `query` (query, required, string) — Artist name Example: `coldplay`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/search/artists?query=coldplay"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "query": "coldplay",
        "artists": [
            {
                "id": "111239",
                "logo": "https://r2.theaudiodb.com/images/media/artist/logo/q094e21667518717.png",
                "mood": "Happy",
                "name": "Coldplay",
                "genre": "Alternative Rock",
                "label": "Parlophone",
                "mb_id": "cc197bad-dc9c-440d-a5b5-d52ba2e14234",
                "style": "Rock/Pop",
                "thumb": "https://r2.theaudiodb.com/images/media/artist/thumb/uxrqxy1347913147.jpg",
                "banner": "https://r2.theaudiodb.com/images/media/artist/banner/xuypqw1386331010.jpg",
                "fanart": "https://r2.theaudiodb.com/images/media/artist/fanart/spvryu1347980801.jpg",
                "gender": "Male",
                "country": "London, England",
                "members": 4,
                "twitter": "1",
                "website": "",
                "facebook": "",
                "alternate": "",
                "biography": null,
                "born_year": 1996,
                "disbanded": null,
                "formed_year": 1996
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:06.730Z",
        "request_id": "b0990ea8-eef6-4326-94ae-6cfdacb7d45f"
    },
    "status": "ok",
    "message": "Artists retrieved successfully",
    "success": true
}
```

### Albums

#### `GET /v1/album` — Album detail

**Parameters:**
- `id` (query, required, string) — Album id Example: `2109614`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/album?id=2109614"
```

**Response:**
```json
{
    "data": {
        "album": {
            "id": "2109614",
            "mood": "Relaxed",
            "name": "A Rush of Blood to the Head",
            "year": 2002,
            "cdart": "https://r2.theaudiodb.com/images/media/album/cdart/vuyruy1429191547.png",
            "genre": "Pop-Rock",
            "label": "Parlophone",
            "mb_id": "120c786d-a3b2-3c19-b4ff-2b7b3b4435bf",
            "score": 8.4,
            "style": "Rock/Pop",
            "thumb": "https://r2.theaudiodb.com/images/media/album/thumb/vsusvs1521243711.jpg",
            "artist": "Coldplay",
            "artist_id": "111239",
            "description": null
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:06.870Z",
        "request_id": "37ddcdf5-bcad-4c9d-9ca8-bb9d50cfb14e"
    },
    "status": "ok",
    "message": "Album retrieved successfully",
    "success": true
}
```

#### `GET /v1/album/tracks` — An album's tracks

**Parameters:**
- `id` (query, required, string) — Album id Example: `2109614`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/album/tracks?id=2109614"
```

**Response:**
```json
{
    "data": {
        "count": 11,
        "tracks": [
            {
                "id": "32724169",
                "name": "Politik",
                "genre": "Pop-Rock",
                "thumb": null,
                "number": 1,
                "duration_ms": 318626,
                "music_video": null
            },
            {
                "id": "32724170",
                "name": "In My Place",
                "genre": "Pop-Rock",
                "thumb": "https://r2.theaudiodb.com/images/media/track/thumb/tvsxqr1340354952.jpg",
                "number": 2,
                "duration_ms": 228733,
                "music_video": "https://www.youtube.com/watch?v=gnIZ7RMuLpU"
            },
            {
                "id": "32724171",
                "name": "God Put a Smile Upon Your Face",
                "genre": "Pop-Rock",
                "thumb": "https://r2.theaudiodb.com/images/media/track/thumb/qytusw1553139856.jpg",
                "number": 3,
                "duration_ms": 297306,
                "music_video": "https://www.youtube.com/watch?v=qhIVgSoJVRc"
            },
            {
                "id": "32724172",
                "name": "The Scientist",
                "genre": "Pop-Rock",
                "thumb": "https://r2.theaudiodb.com/images/media/track/thumb/xuxwwp1340355023.jpg",
                "number": 4,
                "duration_ms": 309160,
                "music_video": "https://www.youtube.com/watch?v=RB-RcX5DS5A"
            },

…(truncated, see openapi.json for full schema)
```

### Discover

#### `GET /v1/trending` — Trending tracks

**Parameters:**
- `country` (query, optional, string) — Country code Example: `us`
- `type` (query, optional, string) — itunes or spotify Example: `itunes`
- `format` (query, optional, string) — singles or albums Example: `singles`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/trending?country=us&type=itunes&format=singles"
```

**Response:**
```json
{
    "data": {
        "type": "itunes",
        "count": 10,
        "format": "singles",
        "country": "us",
        "trending": [
            {
                "album": "This Wasn't Meant for You Anyway",
                "place": 10,
                "track": "Messy",
                "artist": "Lola Young",
                "artist_id": "168085"
            },
            {
                "album": "GNX",
                "place": 9,
                "track": "peekaboo",
                "artist": "Kendrick Lamar",
                "artist_id": "114357"
            },
            {
                "album": "Cool It Down",
                "place": 8,
                "track": "Spitting Off the Edge of the World",
                "artist": "Yeah Yeah Yeahs",
                "artist_id": "112051"
            },
            {
                "album": "Where I've Been, isn't Where I'm Going",
                "place": 7,
                "track": "A Bar Song",
                "artist": "Shaboozey",
                "artist_id": "178899"
            },
            {
                "album": "Short n' Sweet",
                "place": 6,
                "track": "Please Please Please",
                "artist": "Sabrina Carpenter",
                "artist_id": "137425"
            },
            {
                "album": "Beautiful Things",
                "place": 5,
                "track": "Beautiful Things",
                "artist": "Benson Boone",
                "artist_id": "
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/audiodb-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "audiodb-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/album": "Album detail by id.",
            "GET /v1/artist": "Artist detail by id (e.g. 111239).",
            "GET /v1/trending": "Trending tracks (country=, type=itunes|spotify, format=singles|albums).",
            "GET /v1/album/tracks": "An album's track list (album id).",
            "GET /v1/artist/albums": "An artist's albums (artist id).",
            "GET /v1/artist/videos": "An artist's music videos (artist id).",
            "GET /v1/search/artists": "Search artists by name."
        },
        "description": "TheAudioDB music encyclopedia: search artists; artist detail with biography, genre, style, images and socials; an artist's albums and music videos; album detail and tracks; and trending tracks. Real data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:07.199Z",
        "request_id": "117e25bb-9b3b-426e-bcec-897e4ee0e31c"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/audiodb-api
OpenAPI spec: https://www.oanor.com/api/audiodb-api/openapi.json