<aside> ⚠️ We are no longer providing API keys to everyone. Please do reach out if you’re interested in the API, and we’ll try to work something out, but no promises.

</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: