# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/qobuz/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/qobuz/browse-new-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/get-album \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/get-artist \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/get-charts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/get-label \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/get-track \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/qobuz/search-music \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.