Getting started
The SYNK Radio API serves music metadata: tracks, artists, albums, lyrics, charts and audio analysis. It is read-only and CORS is enabled on every route.
You can be sending real requests inside a minute. There are no accounts, no dashboards and no API keys to rotate. Authentication is a single header.
Your first request
Every request needs a User-Agent header containing a contact email. Anything else returns 401.
If something you build hammers the API or scrapes faster than the rate limit allows, having an email lets us reach out before we have to block traffic. It is not validated and not stored for marketing.
A minimum-viable request looks like this:
curl 'https://api.synkradio.co.uk/track/info?artist=Daft%20Punk&title=Around%20the%20World' \
-H 'User-Agent: [email protected]'The response is JSON. Most endpoints respond in under 200 ms on a warm cache.
What to read next
- Authentication covers the header format and what is rejected.
- Rate limits explains per-route limits and the headers you get back.
- Errors lists every status code the API can return and what to do about each.
Once those are sorted, pick an endpoint from the sidebar and try it.