Once installed and running, AzuraCast exposes an API that allows you to monitor and interact with your stations. You can perform the following functions and more from the JSON REST API:
Each AzuraCast installation includes documentation for the API at the exact version it's currently using. If you're interacting with an AzuraCast instance and you're not sure what API endpoints it exposes, you can visit
azuracast.site.name/api/ to view the installation-specific documentation.
Documentation for the latest version of the API can be found on the main AzuraCast site.
If you're accessing sensitive information or modifying the server, you will be required to authenticate your API requests with an authorization key.
You can create an API key from the AzuraCast web interface, by clicking the user menu in the top right and clicking "My API Keys". Any API keys you create will share the same permissions that you have as a user.
The preferred method of authenticating is to send the following header along with your API request:
Authorization: Bearer your_api_key_here
You can also include the API key in the
X-API-Key header if desired.
The most important and frequently accessed pieces of information that AzuraCast stores are all served as part of a single group of data, which we refer to as the "Now Playing" data.
Because of how valuable this information is, we serve it in a number of ways depending on whether performance or flexibility is your main concern.
Check out our Now Playing Data APIs page for more detailed information on these APIs.