Swagger API Explorer

Overview

Tuned Global provides interactive Swagger documentation for both API services. Use these explorers to browse available endpoints, inspect request/response schemas, and test API calls directly from your browser.

Tip: You'll need your StoreId and a valid Bearer token to execute requests. See the DSP Quick Start or Telco Quick Start guide for authentication steps.

Metadata API — v2.3+

Open Metadata API Swagger

The Metadata API provides read-only access to the music catalogue. Use it when user context is not required.

Covers:

• Search — songs, albums, artists, playlists, stations, podcasts, audiobooks
• Catalogue — track details, album info, artist profiles, release data
• Playlists — fetch playlist contents, trending playlists, public user playlists
• Tags — browse and filter by genre, mood, and custom tag groups
• Image Engine — on-the-fly artwork resizing and manipulation
• Content Pages — carousel and CMS-driven content

Base URL: https://api-metadata-connect.tunedglobal.com

Current version: v2.3 and above (use v2.4 endpoints where available for latest features)

Services API — v3

Open Services API Swagger

The Services API handles operations that require user context and authentication.

Covers:

• Authentication — OAuth2 token generation and refresh
• User Management — registration, validation, profiles, device management
• Playback — stream tokens, signed CDN URLs, play logging
• Subscriptions — package status, billing, entitlements
• Content Control — track and product validation for offline and IFE builds
• Playlists — user playlist CRUD operations (create, update, delete, reorder)
• Favourites — track, album, artist, and playlist favouriting

Base URL: https://api-services-connect.tunedglobal.com

Current version: v3

Common Headers

Both APIs require the following headers on most requests: