# Discogs (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 vinyl record listings on the Discogs Marketplace. Retrieve paginated results filterable by format, style, shipping origin, and more, and fetch detailed information on individual listings including pricing, condition, seller details, and shipping options.

**Category:** Marketplaces | **Website:** [www.discogs.com/sell/list?format=Vinyl&ships_from=Netherlands](https://www.discogs.com/sell/list?format=Vinyl&ships_from=Netherlands) | **Docs:** [parse.bot/marketplace/ac97b1e9-47ee-4f4f-9ca4-1dc796c7faf0/discogs-com-api](https://parse.bot/marketplace/ac97b1e9-47ee-4f4f-9ca4-1dc796c7faf0/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-discogs-com-api-ac97b1e9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### fetch_vinyl_listings

Fetch a paginated list of Discogs Marketplace listings. Supports filtering by format, style/genre, shipping origin, sort order, and page size via a full Discogs Marketplace URL. Optionally filter by title/release name. Returns matching items with pricing, condition, seller info, and community data, plus a next-page URL for pagination. If no page_url is provided, returns the first page of Score-style vinyl listings shipping from the Netherlands.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_url` | string | No | Full Discogs Marketplace URL for a specific results page. Supports query parameters such as style, format, format_desc, ships_from, page, limit (25\|50\|100\|250), and sort. If omitted, fetches the first page of results for Score-style vinyl listings shipping from the Netherlands. |
| `title` | string | No | Filter listings by title or release name. Passed as the q parameter to Discogs Marketplace search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-discogs-com-api-ac97b1e9/fetch_vinyl_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_url":"<string>","title":"<string>"}'
```

### get_listing_detail

Get detailed information about a specific Discogs marketplace listing. Returns comprehensive data including price, condition, seller info, release details, and shipping information. The listing_id can be obtained from the listing_id field in fetch_vinyl_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The Discogs marketplace listing ID (numeric string). Can be obtained from the listing_id field returned by fetch_vinyl_listings. |

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