Atlas

Read-only MusiMap Atlas plane. scopes, search include flags, and inventory paths.

MusiMap Atlas is MusiMap's read-only music intelligence catalogue. It holds canonical track, artist, release, and label metadata curated by MusiMap, separate from Workspace catalogues your organisation ingests. Entitled clients can browse and filter Atlas inventory directly under /v1/atlas/*, and can also discover Atlas content through MusiSearch when they need relevance ranking across supported planes.

Read-only. not a customer catalogue

MusiMap Atlas is not listed in GET /v1/catalogs and cannot be targeted by ingestion. Public write paths always deliver into your organisation Workspace catalogues.

What MusiMap Atlas provides

  • MusiMap-curated music metadata for discovery and enrichment.
  • Direct browse and filter inventory under /v1/atlas/*.
  • Optional inclusion in MusiSearch for relevance-based discovery across Workspace and Atlas.
  • Atlas inventory covers tracks, artists, releases, and labels. There is no Atlas works plane.

Authorization

  • OAuth scope atlas.read on your access token.
  • Matching commercial entitlement for MusiMap Atlas access (shown as a capability in the dashboard).
  • For MusiSearch that includes Atlas, also require search.read.

Missing scope or entitlement returns a public error such as insufficient_scope, entitlement_required, or entitlement_revoked. See Errors.

MusiSearch (POST /v1/search/tracks) includes Atlas when you set include_atlas: true (or targets containing atlas). 

curl -X POST "https://api.musimap.com/v1/search/tracks" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "uplifting electronic",
    "include_workspace": false,
    "include_atlas": true,
    "page": 1,
    "page_size": 20
  }'

Full MusiSearch documentation: Catalogue search.

Read Atlas inventory

  • GET /v1/atlas/tracks and GET /v1/atlas/tracks/{track_id}
  • GET /v1/atlas/artists and GET /v1/atlas/artists/{artist_id}
  • GET /v1/atlas/releases and GET /v1/atlas/releases/{release_id}
  • GET /v1/atlas/labels and GET /v1/atlas/labels/{label_id}
curl "https://api.musimap.com/v1/atlas/tracks/$MUSIMAP_TRACK_UUID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

On detail GET, pass include for expansions; unknown tokens return HTTP 400. List endpoints do not support include. List filters use the same semantics as Workspace inventory: identifiers (isrc, outer_id, and similar) are exact (normalized) matches; name / title are case-insensitive substring matches, so name=Tartini matches Giuseppe Tartini; multiple filters AND; pagination applies after filters; unsupported query parameters return HTTP 400. Workspace inventory remains under /v1/workspace/*.

Search provenance

When MusiSearch returns hits from more than one plane, each hit includes source.layer so you can retrieve the full record from the matching inventory path:

source.layer (search only) Meaning
workspace Hit from a catalogue your organisation ingested and owns. Detail: GET /v1/workspace/….
atlas Hit from the MusiMap Atlas read-only catalogue. Detail: GET /v1/atlas/….