This is a port of the official Discogs API client for Python to the version 2.0 of the API. You can use it to query the Discogs music database for metadata on artists, releases, and more.
I guess you should just download the file and include it in your project for now.
>>> import discogs_client as discogs
You also need to set the User-Agent of your client to something unique before you can make requests -- preferably something that follows RFC 1945. Don't just use one of these examples! Make it your own; this will help us get in touch with you if your client is behaving incorrectly.
>>> discogs.user_agent = 'AwesomeDiscogsBrowser/0.1 +http://adb.example.com'
>>> discogs.user_agent = 'LibraryMetadataEnhancer/0.3 +http://example.com/lime'
>>> discogs.user_agent = 'MyDiscogsClient/1.0 +http://mydiscogsclient.org'
There are six classes you can use to fetch data from the API:
ArtistReleaseMasterReleaseLabelSearchUser
Wherever possible, the Discogs client tries to convert API responses into these objects. This enables you to drill down into the object graph as far as you like.
For example, Artists have two convenience properties -- aliases and
releases -- which return Artist and Release objects. To get at the
remainder of an object's metadata, use the data dictionary, which contains the
raw information received from the API.
>>> discogs.Artist('Aphex Twin').data['realname']
u'...'
Query for an artist using the artist's name:
>>> artist = discogs.Artist(7551)
>>> print artist
<Artist "...">
>>> 'name' in artist.data.keys()
True
>>> print artist.name
"Blur"
Get a list of Artists representing this artist's aliases:
>>> artist.aliases
[...]
Get a list of Releases by this artist:
>>> artist.releases
[...]
- images
- members
- name
- namevariations
- realname
- urls
Query for a release using its Discogs ID:
>>> release = discogs.Release(1)
Get the title of this Release:
>>> release.title
u'...'
Get a list of all Artists associated with this Release:
>>> release.artists
[<Artist "...">]
Get the tracklist for this Release:
>>> release.tracklist
[...]
Get the MasterRelease for this Release:
>>> release.master
<MasterRelease "...">
Get a list of all Labels for this Release:
>>> release.labels
[...]
- country
- formats
- genres
- id
- images
- notes
- released_formatted
- released
- status
- styles
- year
Query for a master release using its Discogs ID:
>>> master_release = discogs.MasterRelease(5427)
Get the key Release for this MasterRelease:
>>> master_release.key_release
<Release "...">
Get the title of this MasterRelease:
>>> master_release.title
u'...'
>>> master_release.title == master_release.key_release.title
True
Get a list of all Artists associated with this MasterRelease:
>>> master_release.artists
[<Artist "...">]
Get a list of Releases representing other versions of this MasterRelease:
>>> master_release.versions
[...]
Get the tracklist for this MasterRelease:
>>> master_release.tracklist
[...]
- genres
- id
- images
- styles
- year
Query for a label using the label's name:
>>> label = discogs.Label('Warp Records')
Get a list of Releases from this Label:
>>> label.releases
[...]
Get a list of Labels representing sublabels associated with this Label:
>>> label.sublabels
[...]
Get the Label's parent label, if it exists:
>>> label.parent_label
...
- contactinfo
- images
- name
- profile
- urls
To search the database, pass your query into a Search:
>>> s = discogs.Search('autechre')
There may be results that exactly match your query:
>>> s.exactresults
[...]
Any other results are paginated:
>>> s.results()
[...]
>>> s.results(page=2)
[...]
To query a Discogs user, proceed as follow:
>>> u = discogs.User('username')
Then you may access its collection using
>>> u.collection(sort='year', order='desc', page=1, per_page=25)
[<Release "...">, ...]
If no parameters are provided, the default API settings are used.