# Allmusic — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for music, browse artist biographies and discographies, and retrieve detailed album and song information all in one place. Discover new releases and access comprehensive metadata about artists and tracks.

**Category:** Music | **Website:** [allmusic.com/](https://allmusic.com/) | **Docs:** [parse.bot/marketplace/472b8a63-a645-4144-ae7e-a6042937af8b/allmusic-com-api](https://parse.bot/marketplace/472b8a63-a645-4144-ae7e-a6042937af8b/allmusic-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get album details

Get detailed information about an album, including track listing, genres, styles, rating, credits, and metadata. Tracks and credits are fetched from separate AJAX endpoints on the album page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `album_id` | string | Yes | AllMusic album ID or slug (e.g. 'ok-computer-mw0000024289') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/get_album_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"album_id":"<string>"}'
```

### Get artist details

Get detailed information about an artist, including biography, genres, styles, active dates, and discography. Discography is fetched from the artist's discography page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | AllMusic artist ID or slug (e.g. 'radiohead-mn0000326249') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/get_artist_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>"}'
```

### Get new releases

List current featured new releases from AllMusic's new releases page. Returns all featured releases in a single call with no pagination. Each release includes the AllMusic editorial star rating when available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/get_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get song details

Get detailed information about a song, including composers and albums it appears on.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `song_id` | string | Yes | AllMusic song ID or slug (e.g. 'creep-mt0018232633') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/get_song_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id":"<string>"}'
```

### Search music

Search for artists, albums, songs, or other music items on AllMusic. Returns a single page of results matching the query. When search_type is specified, results are filtered to that category only.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string |
| `search_type` | string | No | Type of search to perform. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-allmusic-com-api-472b8a63/search_music \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","search_type":"<string>"}'
```