Documentation

Everything you need to integrate unified music data into your application. Resolve artists, albums, and tracks across Spotify, Apple Music, YouTube Music, Deezer, and more.

Quick StartAPI Reference

Getting Started

Get up and running with the unremix API in under a minute.

1

Make your first request

Resolve any artist by name or music platform URL. No API key required for basic usage.

Resolve an artist
bash
curl "https://api.unremix.dev/v1/resolve?q=kendrick+lamar"
2

Resolve from a URL

Pass any Spotify, Apple Music, YouTube Music, or Deezer URL directly.

Resolve from Spotify URL
bash
curl "https://api.unremix.dev/v1/resolve?q=https://open.spotify.com/artist/2YZyLoL8N0Wb9xBt1NhZWg"
3

Install an SDK

Use our official SDKs for TypeScript or Python, or the CLI tool.

bash
npm i @unremix/sdk
bash
pip install unremix-sdk

Authentication

Authenticate requests using API keys passed in the X-API-Key header.

Creating an API Key

Generate your key through the dashboard or via our CLI.

Create a key via CLI
bash
unremix keys create --name "Production App"

Store your keys securely. For security, full API keys are only shown once at the time of creation.

Usage Example

Authenticated request
bash
curl "https://api.unremix.dev/v1/resolve?q=radiohead" \
  -H "X-API-Key: your-api-key"

Core Endpoints

The main resolution and search endpoints. All paths are relative to api.unremix.dev/v1.

Full reference

Intelligence Resolution

GET/v1/resolve

Universal resolver. Aggregates artist intelligence from all major platforms.

qstringrequiredArtist name or music platform URL
platformsstringPlatform filter (e.g. spotify,apple-music)
GET/v1/resolve/track

Granular track resolution with multi-platform link mapping.

qstringrequiredTrack name or URL
GET/v1/resolve/album

Complete album intelligence and release data resolution.

qstringrequiredAlbum name or URL

Search & Discovery

GET/v1/artists

Search global artist catalog with platform-specific results.

qstringrequiredSearch query
limitnumberResults limit (default: 20)

Rate Limits

Limits are applied based on your subscription tier to ensure platform stability.

TierRequests/minRequests/day
Free301,000
Pro12010,000
EnterpriseCustomCustom

Respecting Limits

All API responses include rate limit headers. Official SDKs automatically handle retries with exponential backoff.

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
X-RateLimit-Reset: 1709071200
Retry-After: 30

Deep dive into the API?

Explore our comprehensive API reference for detailed response schemas, error codes, and interactive request builders.

Open API Reference