# Discogs Release API Documentation

<p><strong>Discogs Release API Documentation</strong> Get one release by its Discogs id. The answer has title, artists, labels with catalog numbers, formats with descriptions, genres, styles, the full tracklist with positions and durations, credits, identifiers such as barcodes and matrix numbers, notes, images, videos, the master id and the community numbers: have, want, rating average and rating count. The marketplace block has the number of copies for sale and the lowest asking price in the currency you ask for. Find release ids with the search endpoint. Add include_sales_stats=true to get the low, median and high sale price and the date of the last sale from the release page. Each statistics price has its own currency. If Discogs shows no sales block, the field is left out and the add-on is not charged. Suggested prices and the sold price of single listings need a Discogs login and are not available. Cost: 1 credit per release. The sales statistics add-on costs 1 more credit (2 in total). An unknown release (404) and every error cost nothing.</p>

- **Documentation:** [https://scrappa.co/docs/discogs-api/discogs_release](https://scrappa.co/docs/discogs-api/discogs_release)
- **API group:** Discogs API
- **Endpoint:** `GET https://scrappa.co/api/discogs/release`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | Discogs release id. Example: 249504. Take it from the search endpoint. |
| `currency` | string | No | Currency of the lowest price: USD, EUR, GBP, AUD, CAD, JPY, CHF, MXN, BRL, NZD, SEK or ZAR. Default: USD. |
| `include_sales_stats` | boolean | No | true to add the low, median and high sale price and the last sale date. Costs 1 more credit. Default: false. |

## Example response

```json
{
    "data": {
        "id": 249504,
        "url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
        "year": 1987,
        "title": "Never Gonna Give You Up",
        "genres": [
            "Electronic",
            "Pop"
        ],
        "images": [
            {
                "url": "https://i.discogs.com/-DPFA5hKT8i91jnjn4rLB1zSiuUBFTrGWspu1TpLV30/rs:fit/g:sm/q:90/h:600/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9SLTI0OTUw/NC0xMzM0NTkyMjEy/LmpwZWc.jpeg",
                "type": "primary",
                "width": 600,
                "height": 600
            }
        ],
        "labels": [
            {
                "id": 895,
                "name": "RCA",
                "catalog_number": "PB 41447"
            }
        ],
        "status": "Accepted",
        "styles": [
            "Euro-Disco"
        ],
        "videos": [
            {
                "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
                "duration_s": 214
            }
        ],
        "artists": [
            {
                "id": 72872,
                "name": "Rick Astley"
            }
        ],
        "country": "UK",
        "credits": [
            {
                "id": 547352,
                "name": "Me Company",
                "role": "Design",
                "credited_as": "Me Co"
            }
        ],
        "formats": [
            {
                "name": "Vinyl",
                "quantity": 1,
                "descriptions": [
                    "7\"",
                    "45 RPM",
                    "Single",
                    "Stereo"
                ]
            }
        ],
        "released": "1987-07-00",
        "community": {
            "have": 4165,
            "want": 594,
            "rating_count": 250,
            "rating_average": 3.88
        },
        "companies": [
            {
                "id": 82835,
                "name": "BMG Records (UK) Ltd.",
                "type": "Phonographic Copyright (p)"
            }
        ],
        "master_id": 96559,
        "tracklist": [
            {
                "type": "track",
                "title": "Never Gonna Give You Up",
                "duration": "3:32",
                "position": "A"
            },
            {
                "type": "track",
                "title": "Never Gonna Give You Up (Instrumental)",
                "duration": "3:30",
                "position": "B"
            }
        ],
        "date_added": "2004-04-30T08:10:05-07:00",
        "identifiers": [
            {
                "type": "Barcode",
                "value": "5012394144777"
            }
        ],
        "marketplace": {
            "currency": "EUR",
            "lowest_price": 0.68,
            "num_for_sale": 125,
            "blocked_from_sale": false
        },
        "data_quality": "Correct",
        "date_changed": "2022-08-03T03:03:28-07:00",
        "sales_statistics": {
            "low": {
                "amount": 0.62,
                "currency": "USD"
            },
            "high": {
                "amount": 9.64,
                "currency": "USD"
            },
            "median": {
                "amount": 2.3,
                "currency": "USD"
            },
            "last_sale_date": "2025-10-02"
        },
        "estimated_weight_g": 230
    },
    "meta": {
        "credits": 5,
        "billable": true,
        "endpoint_family": "release"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Release Not Found | No release with this id exists on Discogs. This response is not billable. |
| 503 | Service Unavailable | Discogs could not be reached, refused the request or changed its answer. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)