# Allmusic — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.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.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.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.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.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.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>"}'
```