UMG Catalog / 7digital API

This guide describes how to use the 7digital API endpoints to access the UMG catalog made available for this hackathon

Overview

Universal Music Group have made a some of their songs available for this hackathon

  • ≈ 20,000 songs

  • ≈ 1,500 unique artists

  • ≈ 5,000 albums/singles

  • Covers many genres, rock, pop, country....etc

  • Spans each decade from 1960's to present

7digital have activated some of their API endpoints to get access to the UMG catalog

  • Browse catalog and discover artists, albums and tracks

  • Get data for artists, albums and tracks - artist name, album title, track name

  • Retrieve album artwork (CD covers) for every album in the catalog

  • Stream full length audio files for every song in the catalog

API Architecture

Catalog Schema

List of catalog metadata can be found on this page

Accessing UMG Catalog using 7digital API

Access to UMG catalog using 7digital services (API)

  • Provided through a REST style interface

  • Controlled by a consumer key that needs to passed in as a parameter

  • consumer_key = 7d4vr6cgb392

  • Identified by a shop identifier that needs to be passed in as a parameter

  • shopId = 2020

Streaming audio files requires API requests to be signed with an oauth 1.0 signature

  • Sign requests using consumer key and secret

  • consumer_key = 7d4vr6cgb392

  • consumer_secret = m4ntskavq56rddsa

Sample API Call

http://api.7digital.com/1.2/artist/search?shopId=2020&oauth_consumer_key=7d4vr6cgb392&q=john

Call Components

Meaning

http://api.7digital.com/1.2

7digital API site and version

artist/search

API endpoint name - search artists

?shopId=2020

Parameter to identify UMG catalog

&oauth_consumer_key=7d4vr6cgb392

Parameter for consumer key

&q=john

Parameter for search query string

API Endpoint List

The following table lists the endpoints that we have made available for this hackathon. For each endpoint there is a sample call that works and returns real results. Click on these links to see how each call is constructed and obtain the call responses

Endpoint

Use

Sample Call

Main Parameter

Artist browse

Browse the catalog for artist names that start with supplied text string

GET artist/browse

letter={text}

Artist search

Search the catalog for artists that match a supplied text string

GET artist/search

q={text}

Artist releases

Returns a list of streamable releases for a specific artist

GET artist/releases

&artistId={int}

&usageTypes=adsupportedstreaming

Artist toptracks

Returns a list of streamable tracks for a specific artist

GET artist/toptracks

&artistId={int}

&usageTypes=adsupportedstreaming

Release search

Search the catalog for releases

that match a supplied text string

GET release/search

&q={text}

&usageTypes=adsupportedstreaming

Release tracks

Returns a list of streamable tracks for a specific release

GET release/tracks

&releaseId={int}

&usageTypes=adsupportedstreaming

Track search

Search the catalog for releases that match a supplied text string

GET track/search

&q={text}

&usageTypes=adsupportedstreaming

Track stream

Stream full length (or partial clip) audio for a specific track

See later page

&trackId={int}