7digital · JSON Structure

Api Release Structure

A 7digital release (album, single, EP, compilation).

Type: object Properties: 12

MusicStreamingLicensingCatalogueB2BRoyalty ReportingPublic APIs

Release is a JSON Structure definition published by 7digital, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

type id name version artist url image releaseDate label explicit upc price

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "type": "object",
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/7digital/refs/heads/main/json-structure/api-release-structure.json",
  "name": "Release",
  "description": "A 7digital release (album, single, EP, compilation).",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "album",
        "single",
        "ep",
        "compilation"
      ],
      "example": "album"
    },
    "id": {
      "type": "string",
      "description": "7digital release id.",
      "example": "11700062"
    },
    "name": {
      "type": "string",
      "description": "Release title.",
      "example": "Abbey Road"
    },
    "version": {
      "type": "string",
      "description": "Release version (e.g. `Remastered`).",
      "example": "Remastered"
    },
    "artist": {
      "type": "object",
      "description": "A 7digital artist.",
      "properties": {
        "id": {
          "type": "string",
          "description": "7digital artist id.",
          "example": "12345"
        },
        "name": {
          "type": "string",
          "description": "Artist name.",
          "example": "The Beatles"
        },
        "url": {
          "type": "uri",
          "description": "Artist page URL on 7digital.",
          "example": "https://uk.7digital.com/artist/the-beatles"
        },
        "image": {
          "type": "uri",
          "description": "Artist image URL.",
          "example": "https://artwork-cdn.7static.com/static/img/artistimages/00/000/012/0000001234_350.jpg"
        },
        "sortName": {
          "type": "string",
          "description": "Sort form of the artist name.",
          "example": "Beatles, The"
        },
        "appearsAs": {
          "type": "string",
          "description": "Alternative spellings under which the artist appears.",
          "example": "Beatles, The"
        }
      }
    },
    "url": {
      "type": "uri",
      "example": "https://uk.7digital.com/artist/the-beatles/release/abbey-road-11700062"
    },
    "image": {
      "type": "uri",
      "example": "https://artwork-cdn.7static.com/static/img/sleeveart/00/117/000/0011700062_350.jpg"
    },
    "releaseDate": {
      "type": "date",
      "example": "1969-09-26"
    },
    "label": {
      "type": "string",
      "example": "Apple Records"
    },
    "explicit": {
      "type": "boolean",
      "example": false
    },
    "upc": {
      "type": "string",
      "description": "Universal Product Code (UPC/EAN).",
      "example": "00602445912025"
    },
    "price": {
      "type": "object",
      "description": "A price quoted in the requested territory's currency.",
      "properties": {
        "formattedPrice": {
          "type": "string",
          "example": "\u00a39.99"
        },
        "amount": {
          "type": "double",
          "description": "Numeric price value.",
          "example": 9.99
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 currency code.",
          "example": "GBP"
        }
      }
    }
  }
}