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 developers@song.link 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 developers@song.link.

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>"

Rate Limiting

Without an API key, the rate limit is 10 requests per minute. The rate limit with an API key will be higher. If you need to increase your limit, let us know. We'd love to learn more about your use case and increase the rate limit for your API key.