Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Qobuz Albums API

Album metadata retrieval and search

Qobuz Albums API is one of 6 APIs that Qobuz publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Albums. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 2 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.0.3, at version 0.2.

Requests are made against a single base URL, https://www.qobuz.com/api.json/0.2.

2 operations 2 paths 10 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
0.2
Base URL
https://www.qobuz.com/api.json/0.2
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

Qobuz Albums API declares 2 security schemes for authenticating requests. An API key is passed in the query as app_id (AppId). An API key is passed in the header as X-User-Auth-Token (UserAuthToken). By default, every request must be authenticated.

  • AppId — Qobuz application identifier issued to partners
  • UserAuthToken — User authentication token obtained from /user/login

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Albums 2

Album metadata retrieval and search

GET
/album/get
Retrieve album metadata
albumGet 5 params → 200400404
GET
/album/search
Search albums
albumSearch 4 params → 200400

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Album (38 properties), Track (28 properties), Artist (12 properties), Image (5 properties). Each schema is shown below with its type and property counts.

Genre
object
Music genre
4 properties
ErrorResponse
object
Standard error envelope returned by all endpoints on failure
3 properties
TrackList
object
Paginated list of tracks
4 properties
AlbumList
object
Paginated list of albums
4 properties
Image
object
Set of image URLs at various resolutions
5 properties
Label
object
Record label
4 properties
Biography
object
Artist biography
4 properties
Artist
object
Qobuz artist metadata
12 properties
Track
object
Qobuz track metadata
28 properties
Album
object
Qobuz album metadata
38 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

qobuz-albums-api-openapi.yml Raw ↑

Other APIs Qobuz publishes across the network.

Qobuz Artists API
Qobuz Authentication API
Qobuz Playlists API
Qobuz Search API
Qobuz Tracks API