# Muso Platform API — platform.muso.ai

Verified music credits (who did what on a recording), catalog metadata (profiles,
albums, tracks, roles), and audience analytics — the modern, self-serve evolution
of the Muso developer API. REST + MCP + CLI, one meter.

## Auth
Workspace API key from the console, in the `x-api-key` header:
`x-api-key: msk_…` — every key is live; there is no test mode.

## Endpoints (base: https://api.platform.muso.ai/v1)
- GET  /profile/{id}                       profile — name, location, links
- GET  /profile/{id}/credits               verified credits for the profile
- GET  /profile/{id}/charts                chart positions + audience analytics
- GET  /profile/{id}/collaborators         top collaborators
- GET  /track/{idKey}/{idValue}            track by identifier (e.g. isrc/USUG12604763)
- GET  /track/{idKey}/{idValue}/albums     albums containing the track
- GET  /album/{idKey}/{idValue}            album by identifier (e.g. id/{uuid})
- GET  /album/{idKey}/{idValue}/credits    credits for the album
- POST /search                             catalog search ({keyword, type:[track|profile|album]})
- GET  /search/autocomplete?q=             type-ahead suggestions
- GET  /roles                              credit-role taxonomy
Responses use the envelope { "result": "ok", "code": 200, "data": … }.

## Meters & limits
One meter, nothing hidden: `api_requests` (every REST/MCP/CLI call).
- Pay as you go: add a card, get $5 in credits, then pay per call in marginal bands ($0.025 first band, down to $0.015 at scale) — 300 rpm. No base fee, no subscription. Committed enterprise volume prices below the public card.
- Plans (sell the $0.020 rate from call 1): Build $500/mo (25,000 calls included at $0.020/call, 25 rps) · Scale $3,000/mo (150,000 calls included at $0.020/call, 100 rps). Plan money counts toward usage — you only pay the difference. Overage $0.020/call, $0.015 past 300K total monthly calls. Platform Analytics ($3,000/mo minimum) includes the Scale plan.
- Workspace API key: free with Muso Pro/Business — read-only, roster-scoped (your own artists only). Created in the Muso app (app.muso.ai → Settings → API Key), header `workspace-api-key`, host api.muso.ai/api/c/v4a. Separate from the platform's full-catalog pay-as-you-go key (x-api-key). Add profiles to your Muso subscription to read more. Docs: /docs#workspace-key
- Login with Muso (SSO): $99/mo per app — returns the signed-in user's own data, never metered.
- Enterprise: custom contract, signed data terms — required above the abuse ceiling.
Catalog-scale extraction is Enterprise-only under the data licence — money buys usage, never a licence to clone the database. Enforced today by per-key rate limits and the 10× spend ceiling; sustained catalog-scale use is handled as a terms matter, not silently allowed.
Rate limits surface as RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset (seconds
remaining, not a timestamp), plus X-RateLimit-*-Minute; 429s carry Retry-After.
List endpoints page with limit (max 50) + offset; rows are in data.items.

## The one data-use law
Muso data is licensed for in-app consumption only. No resale, no redistribution,
no bulk re-exposure, no catalog reconstruction, no training a competing
credits/stats database. Catalog responses are traceable per key.

## Surfaces (one key, several ways to reach the data)
- REST: the endpoints above — base https://api.platform.muso.ai/v1, header x-api-key: msk_…
- MCP server: 12 tools for Claude/agents; hosted at https://mcp.muso.ai/mcp (no install; x-api-key auth). A local package exists but is not on PyPI yet. Docs: /docs#mcp
- CLI: `muso` — profile/credits/search from the terminal (`go install github.com/Muso-AI/muso-cli/cmd/muso-api@latest`). Docs: /docs#cli
- Embeddable widgets: profile-card + roster via <script src="https://platform.muso.ai/embed/v1.js"> or @muso-ai/embeds (React). Docs: /docs#widgets
- Publishable keys (mpk_): read-only, domain-locked, browser-safe; base https://api.platform.muso.ai/embed/v1 (GET profile/credits/charts/collaborators, CORS-open). Docs: /docs#publishable-keys
- Streaming analytics ($10k/mo tier): live WebSocket deltas — rolling out. Docs: /docs#streaming

## Machine-readable
- OpenAPI 3.1: /openapi.yaml (also /api/openapi)
- Docs: /docs · Guides: /docs#guides · Pricing: /pricing · Status: /system-status
- Fuller agent guide: /llms-full.txt