# Qobuz — 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 and browse millions of songs, albums, and artists on Qobuz to discover new music, explore charts, and access detailed information about tracks and performers. Explore curated new releases and trending charts to stay updated with the latest music across all genres.

**Category:** Music | **Website:** [www.qobuz.com/](https://www.qobuz.com/) | **Docs:** [parse.bot/marketplace/c37d3d16-9e95-47bd-839d-133be73105d1/qobuz-com-api](https://parse.bot/marketplace/c37d3d16-9e95-47bd-839d-133be73105d1/qobuz-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-qobuz-com-api-c37d3d16/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_new_releases

Browse newly released albums on Qobuz. Optionally filter by genre, record label name, or label ID. When label_id is provided, albums are fetched directly from the label's catalog (sorted by newest). Returns paginated results with 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre_id` | string | No | Qobuz genre ID to filter by (e.g. '112' for Pop/Rock, '80' for Jazz, '10' for Classical). Omitting returns all genres. |
| `label` | string | No | Filter results to albums whose record label contains this string (case-insensitive). Omitting returns all labels. |
| `label_id` | string | No | Numeric Qobuz label ID for exact-match filtering (e.g. '9322146' for Armada Music, '7397' for Atlantic Records). Fetches albums directly from the label's catalog. |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qobuz-com-api-c37d3d16/browse_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre_id":"<string>","label":"<string>","label_id":"<string>","page":"<integer>"}'
```

### get_album

Retrieve full details for a single album including tracklist, description, label, genre, and cover art.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `album_id` | string | Yes | Qobuz album identifier or UPC (e.g. '0634904032432'). Also accepts a Qobuz album URL from which the ID is extracted. |

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

### get_artist

Retrieve artist profile including biography, image, and a page of their discography (up to 25 albums).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Numeric Qobuz artist identifier (e.g. '43840'). Also accepts a Qobuz artist URL from which the ID is extracted. |

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

### get_charts

Retrieve the current best-selling albums chart on Qobuz. Optionally filter by genre. Each item includes its chart rank. Returns paginated results with 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre_id` | string | No | Qobuz genre ID to filter by (e.g. '112' for Pop/Rock, '80' for Jazz, '10' for Classical). Omitting returns overall chart. |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qobuz-com-api-c37d3d16/get_charts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre_id":"<string>","page":"<integer>"}'
```

### get_label

Retrieve a label's profile and its upcoming (future-dated) releases with rich album detail including tracklists. Albums are sorted by nearest release date first. Each upcoming album is enriched with full metadata via a per-album detail fetch, so cost scales with page size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `label_id` | string | Yes | Numeric Qobuz label ID (e.g. '9322146'). Also accepts a Qobuz label URL from which the ID is extracted. |
| `page` | integer | No | Page number for pagination of upcoming releases (1-based, 20 items per page). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qobuz-com-api-c37d3d16/get_label \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label_id":"<string>","page":"<integer>"}'
```

### get_track

Retrieve full metadata for a single track including its parent album, duration, genre, performer credits, and whether preview/sample is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `track_id` | string | Yes | Numeric Qobuz track identifier (e.g. '41692580'). Also accepts a Qobuz track URL from which the ID is extracted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qobuz-com-api-c37d3d16/get_track \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_id":"<string>"}'
```

### search_music

Full-text search across the Qobuz catalog. Returns albums, tracks, or artists matching the query. Results are paginated with 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | Yes | Search query text. |
| `type` | string | Yes | Type of content to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-qobuz-com-api-c37d3d16/search_music \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","type":"<string>"}'
```