API reference

The full endpoint reference is published the moment public API access opens. Until then, here is the shape every call shares — the base URL, how you authenticate, and what you get back.

Base URL

Every request goes to a single versioned base, so the path is stable as the API grows.

Authentication

Authenticate each request with your API key in a request header. No OAuth dance, no per-call tokens.

JSON responses

Requests and responses are JSON. Errors return a JSON body with a clear status code and message.

A request at a glance

A call carries your API key in a header and sends a JSON body. This shows the shape — the published reference will list each endpoint and its exact parameters.

# Authenticate with your API key, send and receive JSON
curl https://api.musiccloud.io/api/v1/… \
  -H "X-API-Key: mc_live_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"…"}'

What the API covers

Three capabilities are exposed: resolving a link across streaming services, fetching artist info (top tracks, similar artists, events), and searching the free-to-use Creative Commons catalogue. The reference describes each in full once access is open — read the documentation overview for how to get your key.

Back to documentation