# 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"
```

#### `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"
```

#### `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"
```

#### `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"
```

### 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"
```

#### `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"
```

### 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"
```

### Meta

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

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


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