Discogs API

Base URL

https://api.discogs.com

Authentication

No key needed to fetch a release by id. Database search and image URLs require a personal access token or OAuth. A descriptive User-Agent is mandatory either way.

Rate limit

Roughly 25 requests per minute unauthenticated, 60 with a token. Limits are reported in `X-Discogs-Ratelimit-*` headers.

Pricing

Free. Commercial use is permitted subject to Discogs' API terms.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

curl 'https://api.discogs.com/releases/249504'

const res = await fetch("https://api.discogs.com/releases/249504");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.discogs.com/releases/249504", timeout=20)
res.raise_for_status()
print(res.json())

{
  "id": 249504,
  "status": "Accepted",
  "year": 1987,
  "resource_url": "https://api.discogs.com/releases/249504",
  "uri": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
  "artists": [
    {
      "name": "Rick Astley",
      "anv": "",
      "join": "",
      "role": "",
      "tracks": "",
      "id": 72872,
      "resource_url": "https://api.discogs.com/artists/72872",
      "thumbnail_url": "https://i.discogs.com/Bb1-_pHvbCPFZEZvwoX89glv8Vq7uR_pKeK85ZWhOhA/rs:fit/g:sm/q:90/h:434/w:448/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9BLTcyODcy/LTE3NjMyNzU4MjYt/NTY4My5qcGVn.jpeg"
    }
  ],
  "artists_sort": "Rick Astley",
  "labels": [
    {
      "name": "RCA",
      "catno": "PB 41447",
      "entity_type": "1",
      "entity_type_name": "Label",
      "id": 895,
      "resource_url": "https://api.discogs.com/labels/895",
      "thumbnail_url": "https://i.discogs.com/q-zL2IXAAZL18V9Ova8MTy7NXCoGMloDEKM1yaHpays/rs:fit/g:sm/q:90/h:287/w:600/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9MLTg5NS0x/NzY4MDgxMjYxLTMw/NDIuanBlZw.jpeg"
    }
  ],
  "series": [],
  "companies": [
    {
      "name": "BMG Records (UK) Ltd.",
      "catno": "",
      "entity_type": "13",
      "entity_type_name": "Phonographic Copyright (p)",
      "id": 82835,
      "resource_url": "https://api.discogs.com/labels/82835",
      "thumbnail_url": "https://i.discogs.com/aLAGfAWEPyoZq1-xZ3e1jec6bhXwBFl8f5FDyKid2ss/rs:fit/g:sm/q:90/h:80/w:173/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9MLTgyODM1/LTEyMzMxNzA2NjQu/Z2lm.jpeg"
    },
    {
      "name": "BMG Records (UK) Ltd.",
      "c

title / artists_sort / year / countrystring / integer

Release title, sortable artist credit, year and country of this specific pressing.

artists / extraartistsarray

Main credited artists and the full personnel credits — producers, engineers, session players — each with a Discogs id and role.

labelsarray

Issuing labels with `catno`, the catalogue number printed on the sleeve. This is how collectors identify a pressing.

formatsarray

Physical format detail: vinyl, CD, 7", 12", plus descriptors such as `Single` or `Reissue`.

tracklistarray

Track positions, titles and durations. Position is a string like `A1`, not a number, because vinyl sides exist.

genres / stylesarray

Broad genres and the finer style tags Discogs is known for.

identifiersarray

Barcodes, matrix runouts, rights-society codes and other physical markings.

communityobject

How many users have the release in their collection or wantlist, plus the community rating.

num_for_sale / lowest_priceinteger / float

Live marketplace figures — how many copies are listed and the cheapest asking price.

master_id / master_urlinteger / string

Pointer to the master record that groups every pressing of this album.

videosarray

Community-linked video URLs, usually YouTube, for the tracks.

data_qualitystring

Discogs' own assessment of how complete the entry is, such as `Correct` or `Needs Vote`.

• Look up a pressing by catalogue number for a record-shop inventory
• Enrich a collection app with credits, formats and matrix identifiers
• Check what a specific pressing currently sells for
• Build a discography view by walking from a master to its releases