# Discogs API
> Live data from Discogs, the largest community-built database and marketplace of music releases: search the whole database by text and type (release, artist, label, master), a release with its artists, year, genres, styles, labels and formats plus the collector-community signal (how many have it, want it, its average rating and copies for sale), an artist profile with aliases and members, the canonical master release grouping all editions, and a record label profile with parent and sublabels.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/discogs-api/..."
```

## Pricing
- **Free** (Free) — 7,000 calls/Mo, 2 req/s
- **Basic** ($6/Mo) — 115,000 calls/Mo, 5 req/s
- **Pro** ($16/Mo) — 700,000 calls/Mo, 10 req/s
- **Scale** ($40/Mo) — 3,800,000 calls/Mo, 20 req/s

## Endpoints

### Database

#### `GET /v1/artist` — An artist profile, aliases and members

**Parameters:**
- `id` (query, required, string) — Numeric Discogs artist id Example: `72872`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/artist?id=72872"
```

**Response:**
```json
{
    "data": {
        "id": 72872,
        "uri": "https://www.discogs.com/artist/72872-Rick-Astley",
        "name": "Rick Astley",
        "urls": [
            "http://www.rickastley.co.uk",
            "http://www.facebook.com/RickAstley",
            "http://www.instagram.com/officialrickastley",
            "http://myspace.com/rickastley",
            "http://twitter.com/rickastley",
            "http://en.wikipedia.org/wiki/Rick_Astley",
            "http://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw"
        ],
        "groups": [
            "Band Aid II",
            "Ferry Aid",
            "NHS Voices"
        ],
        "source": "Discogs",
        "aliases": [
            "Dick Spatsley"
        ],
        "members": [],
        "profile": "Rick Astley (b. February 6, 1966 in Newton-le-Willows, Lancashire, United Kingdom) was one of figures to rise up in the dance/pop-driven late '80s. He started as a studio-tea-boy in 1985 at the [l279756] and released his first own single in 1987, [i][m=96559][/i].\r\n\r\nIn 2007, Rick Astley became the subject of a viral internet meme in which millions of internet users were tricked into watching Rick Astley's video [i][url=https://youtu.be/dQw4w9WgXcQ]Never Gonna Give You Up[/url][/i] by posting it under the name of other popular video titles. The practice is now known as [url=https://knowyourmeme.com/memes/rickroll]rickrolling[/url].",
        "real_name": "Richard Paul Astley"
    },
    "meta": {
        "timestamp
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/label` — A record label profile, parent and sublabels

**Parameters:**
- `id` (query, required, string) — Numeric Discogs label id Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/label?id=1"
```

**Response:**
```json
{
    "data": {
        "id": 1,
        "uri": "https://www.discogs.com/label/1-Planet-E",
        "name": "Planet E",
        "urls": [
            "http://planet-e.net",
            "http://planetecommunications.bandcamp.com",
            "http://www.facebook.com/planetedetroit",
            "http://www.flickr.com/photos/planetedetroit",
            "http://www.instagram.com/carlcraignet",
            "http://myspace.com/planetecom",
            "http://myspace.com/planetedetroit",
            "http://soundcloud.com/planetedetroit",
            "http://twitter.com/planetedetroit",
            "http://vimeo.com/user1265384",
            "http://en.wikipedia.org/wiki/Planet_E_Communications",
            "http://www.youtube.com/user/planetedetroit"
        ],
        "source": "Discogs",
        "profile": "[a=Carl Craig]'s classic techno label founded in 1991.\r\n\r\nOn at least 1 release, Planet E is listed as publisher.",
        "sublabels": [
            "Antidote (4)",
            "Community Projects",
            "Guilty Pleasures",
            "I Ner Zon Sounds",
            "Planet E Communications",
            "Planet E Communications, Inc.",
            "Planet E Productions",
            "TWPENTY"
        ],
        "contact_info": "Planet E Communications\r\nP.O. Box 27218\r\nDetroit, Michigan, MI 48227\r\nUSA\r\n\r\nPhone: +1 313 874 8729\r\nFax: +1 313 874 8732\r\nEmail: info@Planet-e.net",
        "parent_label": null
    },
    "meta": {
        "timestamp"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/master` — A master release grouping all editions

**Parameters:**
- `id` (query, required, string) — Numeric Discogs master id Example: `8295`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/master?id=8295"
```

**Response:**
```json
{
    "data": {
        "id": 8295,
        "uri": "https://www.discogs.com/master/8295-Growing-Lateral",
        "year": 2008,
        "title": "Lateral",
        "genres": [
            "Electronic"
        ],
        "source": "Discogs",
        "styles": [
            "Drone",
            "Experimental",
            "Ambient"
        ],
        "artists": [
            "Growing"
        ],
        "track_count": 4,
        "main_release": 1244906
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:44.984Z",
        "request_id": "3c624414-4647-4511-8509-d4a14fedb55b"
    },
    "status": "ok",
    "message": "Master retrieved successfully",
    "success": true
}
```

#### `GET /v1/release` — A release with community have/want/rating

**Parameters:**
- `id` (query, required, string) — Numeric Discogs release id Example: `249504`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/release?id=249504"
```

**Response:**
```json
{
    "data": {
        "id": 249504,
        "uri": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
        "year": 1987,
        "title": "Never Gonna Give You Up",
        "genres": [
            "Electronic",
            "Pop"
        ],
        "labels": [
            {
                "name": "RCA",
                "catno": "PB 41447"
            }
        ],
        "source": "Discogs",
        "styles": [
            "Euro-Disco"
        ],
        "artists": [
            "Rick Astley"
        ],
        "country": "UK",
        "formats": [
            {
                "qty": 1,
                "name": "Vinyl",
                "descriptions": [
                    "7\"",
                    "45 RPM",
                    "Single",
                    "Stereo"
                ]
            }
        ],
        "released": "1987-07-00",
        "community": {
            "have": 4047,
            "want": 580,
            "rating_count": 231,
            "rating_average": 3.84
        },
        "track_count": 2,
        "lowest_price": 0.89,
        "num_for_sale": 115
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:45.463Z",
        "request_id": "809855f4-b2d5-45dd-8790-8265eea39700"
    },
    "status": "ok",
    "message": "Release retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Search the Discogs database

**Parameters:**
- `q` (query, required, string) — Search term Example: `nirvana`
- `type` (query, optional, string) — release, artist, label or master Example: `artist`
- `per_page` (query, optional, string) — Results per page (max 50) Example: `20`
- `page` (query, optional, string) — Page number Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/search?q=nirvana&type=artist&per_page=20&page=1"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "type": "artist",
        "count": 20,
        "query": "nirvana",
        "source": "Discogs",
        "results": [
            {
                "id": 125246,
                "type": "artist",
                "year": null,
                "genre": [],
                "label": [],
                "thumb": null,
                "title": "Nirvana",
                "format": [],
                "country": null
            },
            {
                "id": 307513,
                "type": "artist",
                "year": null,
                "genre": [],
                "label": [],
                "thumb": null,
                "title": "Nirvana (2)",
                "format": [],
                "country": null
            },
            {
                "id": 2744248,
                "type": "artist",
                "year": null,
                "genre": [],
                "label": [],
                "thumb": null,
                "title": "Nirvana (10)",
                "format": [],
                "country": null
            },
            {
                "id": 1087206,
                "type": "artist",
                "year": null,
                "genre": [],
                "label": [],
                "thumb": null,
                "title": "Nirvana 2002",
                "format": [],
                "country": null
            },
            {
                "id": 1082359,
                "type": "artist",
     
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/discogs-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Discogs API (api.discogs.com, live)",
        "service": "discogs-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/label": "A record label's profile, parent and sublabels (id=1).",
            "GET /v1/artist": "An artist's profile, aliases and members (id=72872).",
            "GET /v1/master": "A master release grouping all editions (id=8295).",
            "GET /v1/search": "Search the Discogs database (q=nirvana, type=release|artist|label|master).",
            "GET /v1/release": "A release with community have/want/rating (id=249504)."
        },
        "description": "Live data from Discogs, the largest community-built database and marketplace of music releases, via its public API. The search endpoint searches the whole database by text and type (release, artist, label, master); the release endpoint returns a release's artists, year, country, genres, styles, labels and formats plus the collector-community signal (how many have it, want it, its average rating and copies for sale); the artist endpoint returns an artist's profile, aliases, members and links; the master endpoint returns the canonical master release grouping all editions; the label endpoint returns a record label's profile, parent and sublabels. Live, no key, nothing stored. Distinct from the MusicBrainz, Spotify, Deezer, Genius and Last.fm-style music APIs — this is Discogs' own community-built release database with have/wan
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/discogs-api
OpenAPI spec: https://www.oanor.com/api/discogs-api/openapi.json