# Discogs (api.discogs.com) — 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 music releases, artists, and labels to discover tracklists, formats, ratings, and complete discography information. Instantly access detailed release data including community feedback to build your music knowledge and collections.

**Category:** Music | **Website:** [api.discogs.com/](https://api.discogs.com/) | **Docs:** [parse.bot/marketplace/4885ead7-3534-442c-8cc1-d211b3b808d4/api-discogs-com-api](https://parse.bot/marketplace/4885ead7-3534-442c-8cc1-d211b3b808d4/api-discogs-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-api-discogs-com-api-4885ead7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_releases

Retrieve paginated releases for a specific artist. Each release includes title, year, format, label, and the artist's role. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Numeric Discogs artist ID. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (max 100). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-api-discogs-com-api-4885ead7/get_artist_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### get_label_releases

Retrieve paginated releases for a specific record label. Each release includes title, artist, year, format, catalog number, and thumbnail. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `label_id` | string | Yes | Numeric Discogs label ID. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (max 100). |

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

### get_release

Retrieve full details for a specific release including tracklist, formats, labels, artists, genres, styles, community ratings, and notes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `release_id` | string | Yes | Numeric Discogs release ID. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-api-discogs-com-api-4885ead7/get_release \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"release_id":"<string>"}'
```

### search_releases

Search the Discogs database for releases with optional filters for artist, label, year, and format. Returns paginated results with basic metadata. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist` | string | No | Filter by artist name. |
| `format` | string | No | Filter by format (e.g. Vinyl, CD, Cassette). |
| `label` | string | No | Filter by label name. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (max 100). |
| `query` | string | No | Free-text search query. |
| `year` | string | No | Filter by release year (e.g. 1991). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-api-discogs-com-api-4885ead7/search_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist":"<string>","format":"<string>","label":"<string>","page":"<integer>","per_page":"<integer>","query":"<string>","year":"<string>"}'
```