MusicBrainz · Schema

MusicBrainz Recording

Schema for a MusicBrainz Recording entity (a distinct audio capture of a performance) as returned by the Web Service v2.

MusicMetadataEncyclopediaOpen DataCatalogIdentifiersISRCISWCMBIDDiscIDArtistsReleasesRecordingsWorksLabelsCover ArtOpen-SourceNon-Profit

Properties

Name Type Description
id string
title string
length integernull Length in milliseconds.
video boolean True if the recording is a music video rather than audio only.
disambiguation string
first-release-date stringnull Earliest known release date for this recording.
isrcs array International Standard Recording Codes.
artist-credit array
releases array
tags array
rating object
relations array
View JSON Schema on GitHub

JSON Schema

musicbrainz-recording-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://musicbrainz.org/schemas/recording",
  "title": "MusicBrainz Recording",
  "description": "Schema for a MusicBrainz Recording entity (a distinct audio capture of a performance) as returned by the Web Service v2.",
  "type": "object",
  "properties": {
    "id": {"type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},
    "title": {"type": "string", "examples": ["Smells Like Teen Spirit"]},
    "length": {"type": ["integer", "null"], "description": "Length in milliseconds.", "examples": [301920]},
    "video": {"type": "boolean", "description": "True if the recording is a music video rather than audio only."},
    "disambiguation": {"type": "string"},
    "first-release-date": {"type": ["string", "null"], "description": "Earliest known release date for this recording."},
    "isrcs": {"type": "array", "items": {"type": "string", "pattern": "^[A-Z]{2}[A-Z0-9]{3}[0-9]{7}$"}, "description": "International Standard Recording Codes."},
    "artist-credit": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {"type": "string"},
          "joinphrase": {"type": "string"},
          "artist": {
            "type": "object",
            "properties": {
              "id": {"type": "string"},
              "name": {"type": "string"},
              "sort-name": {"type": "string"},
              "disambiguation": {"type": "string"}
            }
          }
        }
      }
    },
    "releases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {"type": "string"},
          "title": {"type": "string"},
          "status": {"type": ["string", "null"]},
          "date": {"type": ["string", "null"]},
          "country": {"type": ["string", "null"]}
        }
      }
    },
    "tags": {"type": "array", "items": {"type": "object", "properties": {"name": {"type": "string"}, "count": {"type": "integer"}}}},
    "rating": {"type": "object", "properties": {"value": {"type": ["number", "null"]}, "votes-count": {"type": "integer"}}},
    "relations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {"type": "string"},
          "type-id": {"type": "string"},
          "direction": {"type": "string", "enum": ["forward", "backward"]},
          "target-type": {"type": "string"},
          "work": {"type": "object"},
          "artist": {"type": "object"},
          "url": {"type": "object"}
        }
      }
    }
  },
  "required": ["id", "title"]
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema 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 Schema
curl "https://apis.io/api/v1/json-schemas/musicbrainz-recording"
All schemas
curl "https://apis.io/api/v1/json-schemas?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.