<aside> ⚠️

Deprecation notice — Songlink (Odesli) public API

The entire v1-alpha.1 API namespace is deprecated and will be retired on July 31, 2026. Until then, requests are subject to stricter per-IP daily rate limits; over-quota requests return 429 Too Many Requests. After the sunset date, all v1-alpha.1 endpoints will return 410 Gone.

Partners with a legitimate, sustained need for API access can request allowlisting via the form in the Help Center article: Sunsetting the Songlink (Odesli) public API.

The public song.link / album.link landing pages are not affected by this change.

</aside>

v1-alpha.1

Information, documentation for Songlink's public API, currently on version 1-alpha.1.

What is an alpha release?

I'm not sure. 😅 This is our first attempt at opening up our data with an API, so I suspect we'll want to improve things as we learn about how developers use it or want to use it. We've labeled this as an "alpha" version meaning things may break or change, but we'll do our best to communicate those changes.

Please don't hesitate to reach out to us at [email protected] with feedback or suggestions.

Versioning

This is the documentation for Songlink API version 1-alpha.1. The API request and response structures may change. In the case of breaking changes, a new version of the API will be supported.

Requests to the API should specify the version of the API you'd like to consume:

curl -X GET "<https://api.song.link/{{VERSION}}/links?..."

e.g. for v1-alpha.1:

curl -X GET "<https://api.song.link/v1-alpha.1/links?.>.."

Attribution

Please properly attribute your integration with our API by displaying to your users that your feature or product is powered by Songlink. We're really flexible on this; if you have any questions or concerns please reach out to us at [email protected].

Terms of Service

Use of our API is governed by our API Terms of Service.

Auth

You do not need any special authentication or authorization for our API. However, if you do provide a valid API key you will benefit from higher rate limits and preferred support. If interested, send us an email and we'll send you an API key. Then, add it as the key query param, like so:

curl -X GET "<https://api.song.link/v1-alpha.1/links?url=spotify%3Atrack%3A0Jcij1eWd5bDMU5iPbxe2i&userCountry=US&key=9ed95450-2b6f-4aae-a3ab-34b6bca4f786>"