Web API

Task-oriented guides — how to authenticate, send audio, read results, search, and integrate MusiMap into your product.

Start the quickstart OpenAPI reference

How it's organised

The Web API section is task-oriented. Each guide walks you through an end-to-end integration — authentication, submitting work, reading results, handling edge cases. If you instead need to understand what a specific value means, that is the job of the References section.

Every guide follows the same shape:

  • When to use it — the product question this feature answers.
  • What you need — credentials, scopes, and any prerequisites.
  • End-to-end example — copy/paste code in cURL where applicable.
  • Response shape — with a link to the full reference in the OpenAPI spec.
  • Gotchas — the mistakes we see most often in real integrations.

Get started

5 minutes

Quickstart

OAuth token, presigned S3 upload, and your first live MusiTag call.

Integration guide

How V1 endpoints combine into live tagging, ingestion, and search workflows.

Authentication (OAuth2)

Client-credentials flow, token lifecycle and documented scopes.

Status & versioning

/v1 versioning, /openapi/v1.json, and public status endpoints.

OpenAPI reference

Interactive browse of every V1 endpoint plus raw JSON download.

Core features (V1)

Catalogue management and technical inventory. Each card links to a full guide.

Catalogues

List catalogues available to your OAuth client.

 Catalogue

Ingestions

Create ingestions and inspect delivery status, entities, items, and stats.

Storage

Presigned inbound uploads, object listing, delete, and optional storage credentials.

Tracks

Technical catalogue inventory for ingested tracks.

Artists

Technical inventory for ingested artists.

Releases

Technical inventory for ingested releases.

Works

Technical inventory for ingested musical works.

Product features (V1)

MusiTag, MusiSearch, and MusiProfile capabilities.

MusiTag

Tagging

Live tagging from S3 and stored tagging lookup for catalogued tracks.

Taxonomy

Stable tag IDs grouped by category for MusiSearch filters.

 MusiSearch

Catalogue search

Track discovery with text, tag ID filters, and audio attributes.

 MusiProfile

Profiling

Aggregate listener profiles for a list of analysed catalogue tracks.
  • References — error shapes, pagination, scopes, and OpenAPI.
  • SDKs — official client libraries.
  • Status — current platform health and past incidents.

Building beyond the guides?

For fingerprinting, webhooks, advanced discovery, or custom integration paths, contact the MusiMap team — we’ll help you map the right workflow for your product.

Contact the team Integration guide