Musicfetch API docs

Musicfetch is a music metadata and link matching API. Use it to search music catalogs, resolve streaming-service URLs, match songs and albums across platforms, look up ISRC and UPC identifiers, and check music distribution availability.

Getting started

To access the Musicfetch endpoints you'll need a subscription. Head to the homepage and pick a plan. All plans start with a free 7 day trial.

Authorization

All the Musicfetch endpoints require an Access Token. Copy an access token from your Account page. You can create up to 5 access tokens at any one time. A token must be provided whenever you call the API.

curl https://api.musicfetch.io/isrc?isrc=USUG11901472&services=appleMusic \
  -H 'x-token: YOUR_TOKEN'

Access tokens are secret and should not be exposed to the browser, as someone could steal your token and make requests on your behalf.

Rate limits

Authenticated API responses include rate-limit headers so your application can monitor capacity and schedule retries.

Header	Description
`RateLimit-Limit`	Your account's request capacity. The bucket refills continuously at this many requests per minute.
`RateLimit-Remaining`	Whole requests available after the current request is admitted.
`RateLimit-Reset`	Unix timestamp in seconds when the bucket would be full if no more requests were made. This is a full-refill time, not a fixed window boundary.
`Retry-After`	Seconds until one request can be admitted. This header is returned only with a `429 Too Many Requests` response.

For example, a successful response might include:

RateLimit-Limit: 120
RateLimit-Remaining: 87
RateLimit-Reset: 1790812817

Rate limits belong to the account and are shared by all of its access tokens. Header values are snapshots, so concurrent requests may use capacity before your next request. A request consumes capacity once it is admitted, even if the lookup later returns an error.

When the API returns 429 Too Many Requests, wait for the number of seconds in Retry-After before retrying. This can be earlier than RateLimit-Reset, because only enough capacity for one request is required.

API Endpoints

Musicfetch provides several endpoints to look up music metadata:

Search music by query - Search for tracks, albums, and artists
URL Lookup - Lookup tracks, albums, and artists using platform URLs
ISRC Lookup - Lookup tracks using ISRC codes
UPC Lookup - Lookup albums using UPC codes

For a product-level overview, read the Music Metadata API guide.

SDK

For JavaScript/TypeScript projects, we recommend using our official SDK which provides a type-safe interface and includes brand assets to help you build your UI quickly.