Home
Discogs
Discogs Release Structure
Discogs Release Structure
Represents a particular physical or digital object released by one or more Artists.
Type: object
Properties: 31
Music Marketplace Catalog Community Vinyl Public APIs
Release is a JSON Structure definition published by Discogs, describing 31 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
id
title
resource_url
uri
status
data_quality
thumb
country
year
notes
released
released_formatted
date_added
date_changed
lowest_price
num_for_sale
estimated_weight
format_quantity
master_id
master_url
artists
labels
extraartists
formats
genres
styles
community
companies
tracklist
videos
identifiers
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/discogs/refs/heads/main/json-structure/discogs-release-structure.json",
"name": "Release",
"description": "Represents a particular physical or digital object released by one or more Artists.",
"type": "object",
"properties": {
"id": {
"type": "int32",
"readOnly": true
},
"title": {
"type": "string"
},
"resource_url": {
"type": "uri",
"readOnly": true
},
"uri": {
"type": "uri",
"readOnly": true
},
"status": {
"type": "string"
},
"data_quality": {
"type": "string"
},
"thumb": {
"type": "uri"
},
"country": {
"type": "string",
"nullable": true
},
"year": {
"type": "int32",
"nullable": true
},
"notes": {
"type": "string",
"nullable": true
},
"released": {
"type": "string",
"description": "Release date in a free-text format."
},
"released_formatted": {
"type": "string",
"description": "Formatted release date."
},
"date_added": {
"type": "datetime"
},
"date_changed": {
"type": "datetime"
},
"lowest_price": {
"type": "float",
"nullable": true
},
"num_for_sale": {
"type": "int32",
"nullable": true
},
"estimated_weight": {
"type": "int32",
"nullable": true
},
"format_quantity": {
"type": "int32"
},
"master_id": {
"type": "int32",
"nullable": true
},
"master_url": {
"type": "uri",
"nullable": true
},
"artists": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ArtistSummary"
}
},
"labels": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LabelSummary"
}
},
"extraartists": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ArtistSummary"
}
},
"formats": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ReleaseFormat"
}
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"styles": {
"type": "array",
"items": {
"type": "string"
}
},
"community": {
"$ref": "#/components/schemas/Community"
},
"companies": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LabelSummary"
}
},
"tracklist": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Track"
}
},
"videos": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Video"
}
},
"identifiers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Identifier"
}
}
}
}
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/discogs-release-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.