Spinitron v2 API
Notes
Tutorial demo using this API is at https://spinitron.com/v2-api-demo/. For web integration using iframes and/or JavaScript instead of an API, see https://spinitron.github.io/v2-web-integration/.
Your API key is found in the Spinitron web app. Log in to Spinitron and go to Automation & API in the Admin menu.
Authenticate by presenting your API key using either HTTP Bearer Authorization (preferred)
curl -H 'Authorization: Bearer YOURAPIKEY' 'https://spinitron.com/api/spins'
or in the query parameter access-token (less secure owing to webserver
log files)
curl 'https://spinitron.com/api/spins?access-token=YOURAPIKEY'
Limit per page of results is 20 by default and miximally 200.
Try it out below works to generate example cURL requests but not to get responses from Spinitron. We do not accept queries sent from web browsers. Copy-paste the cURL commands and run them from your computer.
Cache the data you get from the API if you are using it in web or mobile integration. It's not ok to query the API on every page request you serve. The demo shows how easy it can be to implement a file cache.
An extension to this API with access to all stations for partner applications is available. Contact us.
https://spinitron.com/apiAuth: unknown
Endpoints: 8
Reachable: unknown
CORS: unknown
Topics
Endpoints
| Method | Path | Summary | Auth | Last Status | Latency |
|---|---|---|---|---|---|
GET |
/personas | Get Personas | — | — | — |
GET |
/personas/{id} | Get Persona by id | — | — | — |
GET |
/playlists | Returns playlists optionally filtered by {start} and/or {end} datetimes | — | — | — |
GET |
/playlists/{id} | Get a Playlist by id | — | — | — |
GET |
/shows | Returns scheduled shows optionally filtered by {start} and/or {end} datetimes | — | — | — |
GET |
/shows/{id} | Get a Show by id | — | — | — |
GET |
/spins | Returns spins optionally filtered by {start} and/or {end} datetimes | — | — | — |
GET |
/spins/{id} | Get a Spin by id | — | — | — |