---
id: discogs-client
version: "2.3.0"
license: unclear
license_treatment: permissive
maintenance: abandoned
---

# discogs-client — Official Python API client for Discogs

License: permissive · Maintenance: abandoned · Downloads: 75.1K/mo

## What it is and what it does

discogs_client is an official Python wrapper around the Discogs REST API, allowing you to programmatically search and retrieve information about artists, releases, labels, and users in the Discogs music database. It handles HTTP communication via requests and supports OAuth 1.0a authentication through oauthlib, letting you authenticate as a Discogs user to access protected operations like modifying collections and wantlists.

The package provides object-oriented access to Discogs entities—you instantiate a Client, then call methods like search(), artist(), release(), or master() to fetch data and navigate relationships. It abstracts away direct REST calls and pagination, making it simpler to write Python scripts that interact with Discogs. However, the package has been abandoned since 2020-06-01 and is no longer maintained, so it will not receive updates if the Discogs API evolves or if compatibility issues arise with newer Python or dependency versions.

Use it for:

- Build a music collection manager that syncs vinyl records or CDs with Discogs to track ownership and wantlists.
- Scrape Discogs metadata (artist names, release dates, track listings) for music research or data analysis projects.
- Integrate Discogs artist and release information into a music recommendation or discovery application.
- Automate marketplace order or inventory management for sellers using Discogs' OAuth-authenticated endpoints.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for querying and modifying data in the Discogs music database via its REST API, supporting artist, release, label, and user information lookups as well as OAuth 1.0a authentication.

No—do not install. The package is abandoned and unmaintained since 2020-06-01. While it has low install friction and a permissive license, the lack of active maintenance means no security updates, no compatibility fixes, and no support if the Discogs API changes. For new projects, use a generic REST client directly with the Discogs API documentation.

## Install

pip install discogs-client
uv add discogs-client
poetry add discogs-client

## Installing discogs-client

Before you install: Installation is straightforward with low friction, but the package is abandoned with no active maintenance. The repository is archived and no updates have been released since 2020-06-01, so you should expect no bug fixes or security patches going forward.

License in practice: Licensed under a permissive BSD license, so you can use it freely in commercial and private projects without copyleft obligations.

Quickstart:

pip install discogs_client

import discogs_client
d = discogs_client.Client('ExampleApplication/0.1')
results = d.search('Stockholm By Night', type='release')
artist = results[0].artists[0]

Verify before relying:

- Whether the Discogs REST API has changed in ways that would break this client since 2020-06-01.
- Whether the dependencies (requests, six, oauthlib) remain compatible with modern Python versions.
- Current rate-limiting or authentication requirements on the Discogs API that may affect real-world usage.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 75.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

discogs api client, music database python, discogs query library, vinyl record metadata, discogs oauth authentication, music-metadata, rest-api-client, abandoned

[View on SkillFed](https://skillfed.io/packages/discogs-client) · [View on PyPI](https://pypi.org/project/discogs-client/)