Discogs

🚀 Quickstart

Connect to Discogs with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Discogs. Enter the consumer key and consumer secret of your Discogs app (see the setup guide below).

Authorize Discogs

Go to Connections -> Add Test Connection -> Authorize, then log in to Discogs. Later, you’ll let your users do the same directly from your app.

Call the Discogs API

Let’s make your first request to the Discogs API (fetch the authenticated user’s identity). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/oauth/identity" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/oauth/identity',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our quickstart to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Discogs integration guides

Nango maintained guides for common use cases.

How to register your own Discogs OAuth app Register an OAuth app with Discogs and obtain credentials to connect it to Nango.

Official docs: Discogs API documentation

API gotchas

Discogs uses OAuth 1.0a (not OAuth 2), with the PLAINTEXT signature method.
Discogs requires a unique User-Agent header on every API request. Nango sets one automatically for proxy requests.
Discogs rate limits authenticated requests to 60 per minute per user. Check the X-Discogs-Ratelimit-Remaining response header.
For single-user scripts, you can use a Discogs personal access token instead of OAuth.

🧩 Pre-built syncs & actions for Discogs

Enable them in your dashboard. Extend and customize to fit your needs.

Collection

Function name	Description	Type	Source code
`add-to-collection`	Add a release to a collection folder.	Action	🔗 Github
`create-collection-folder`	Create a collection folder.	Action	🔗 Github
`delete-collection-folder`	Delete a collection folder.	Action	🔗 Github
`get-collection-value`	Get the minimum, median, and maximum value of a collection.	Action	🔗 Github
`remove-from-collection`	Remove a release instance from a collection folder.	Action	🔗 Github
`update-collection-folder`	Update a collection folder name.	Action	🔗 Github
`collection`	Sync collection folders and releases for the authenticated user.	Sync	🔗 Github
`collection`	Sync collection folders and releases for the authenticated user.	Sync	🔗 Github

Contributions

Function name	Description	Type	Source code
`contributions`	Sync release contributions for the authenticated user.	Sync	🔗 Github

Database

Function name	Description	Type	Source code
`get-artist`	Get an artist by ID.	Action	🔗 Github
`get-label`	Get a label by ID.	Action	🔗 Github
`get-master`	Get a master release by ID.	Action	🔗 Github
`get-release`	Get a release by ID.	Action	🔗 Github
`search`	Search the Discogs database.	Action	🔗 Github

Inventory

Function name	Description	Type	Source code
`inventory`	Sync marketplace inventory listings for the authenticated user.	Sync	🔗 Github

Lists

Function name	Description	Type	Source code
`lists`	Sync user lists and their items.	Sync	🔗 Github
`lists`	Sync user lists and their items.	Sync	🔗 Github

Marketplace

Function name	Description	Type	Source code
`add-order-message`	Add a message to a marketplace order.	Action	🔗 Github
`create-listing`	Create a new marketplace listing.	Action	🔗 Github
`delete-listing`	Delete a marketplace listing.	Action	🔗 Github
`export-inventory`	Request an inventory export for the authenticated user.	Action	🔗 Github
`get-fee`	Calculate the marketplace fee for a listing price.	Action	🔗 Github
`get-inventory-export`	Get a specific inventory export by ID.	Action	🔗 Github
`get-inventory-exports`	List inventory exports for the authenticated user.	Action	🔗 Github
`get-listing`	Get a marketplace listing by ID.	Action	🔗 Github
`get-order-messages`	Get messages for a marketplace order.	Action	🔗 Github
`get-order`	Get a marketplace order by ID.	Action	🔗 Github
`get-price-suggestions`	Get marketplace price suggestions for a release.	Action	🔗 Github
`update-listing`	Update a marketplace listing.	Action	🔗 Github
`update-order-status`	Update the status of a marketplace order.	Action	🔗 Github

Orders

Function name	Description	Type	Source code
`orders`	Sync marketplace orders for the authenticated user.	Sync	🔗 Github

Profile

Function name	Description	Type	Source code
`profile`	Sync the authenticated Discogs user profile.	Sync	🔗 Github

Submissions

Function name	Description	Type	Source code
`submissions`	Sync release submissions for the authenticated user.	Sync	🔗 Github

Wantlist

Function name	Description	Type	Source code
`add-to-wantlist`	Add a release to the wantlist.	Action	🔗 Github
`remove-from-wantlist`	Remove a release from the wantlist.	Action	🔗 Github
`wantlist`	Sync the authenticated user wantlist.	Sync	🔗 Github

Overview

1,000+ APIs & Integrations

🚀 Quickstart

📚 Discogs integration guides

API gotchas

🧩 Pre-built syncs & actions for Discogs

Collection

Contributions

Database

Inventory

Lists

Marketplace

Orders

Profile

Submissions

Wantlist

​🚀 Quickstart

​📚 Discogs integration guides

​API gotchas

​🧩 Pre-built syncs & actions for Discogs

​Collection

​Contributions

​Database

​Inventory

​Lists

​Marketplace

​Orders

​Profile

​Submissions

​Wantlist

🚀 Quickstart

📚 Discogs integration guides

API gotchas

🧩 Pre-built syncs & actions for Discogs

Collection

Contributions

Database

Inventory

Lists

Marketplace

Orders

Profile

Submissions

Wantlist