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 Search API

Cross-catalog search across all content types

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

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

This API exposes 1 operation across 1 path, and defines 14 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.

1 operations 1 paths 14 schemas 1 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 Search 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 1

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

Search 1

Cross-catalog search across all content types

GET
/catalog/search
Cross-catalog search
catalogSearch 6 params → 200400

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Album (38 properties), Track (28 properties), Playlist (22 properties), Artist (12 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
ArtistList
object
Paginated list of artists
4 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
PlaylistList
object
Paginated list of playlists
4 properties
Artist
object
Qobuz artist metadata
12 properties
Track
object
Qobuz track metadata
28 properties
Playlist
object
Qobuz playlist metadata and tracks
22 properties
Album
object
Qobuz album metadata
38 properties
SearchResults
object
Aggregated search results across all content types
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

qobuz-search-api-openapi.yml Raw ↑

Other APIs Qobuz publishes across the network.

Qobuz Albums API
Qobuz Artists API
Qobuz Authentication API
Qobuz Playlists API
Qobuz Tracks API