AIR is our broadcaster API. It offers several simple methods to allow broadcasters and other publishers to send radio directory content to TuneIn in realtime.
When you implement the AIR API, your listeners will:
- See current artist album artwork on TuneIn.com player
- Discover your station by searching for your artists
- Browse station playlist history on TuneIn mobile and TuneIn.com
Please e-mail email@example.com your TuneIn station URL (search for your station on TuneIn.com) for permission to use the API, and we will grant a partnerId and partnerKey. If you use a special broadcaster software, let us know as well.
Some software makes it easy to use the AIR API via a plugin. You still need to request a partnerId and partnerKey for your station.
Broadcast Electronics' The Radio Experience includes a plugin.
Requests to the Air API are very simple:
# Update the song now playing on a station GET http://air.radiotime.com/Playing.ashx?partnerId=<id>&partnerKey=<key>&id=<stationid>&title=Bad+Romance&artist=Lady+Gaga
Your partnerId replaces <id>, partnerKey replaces <key>, and stationId, including the preliminary 's' replaces <stationid>. Your title and artist information should be set to be updated by your broadcast software in correspondence with the currently playing song.
|title||The name of the song|
|artist||The artist associated with the song|
|album||The name of the associated album|
|commercial||Set to true if the now playing broadcast is in commercial rather than a song|
OutputCheck the status code for success or failure result (200 means success)
For now playing updates, please submit only once at the start of the song. Do not use a timer to submit a song, or submit a song multiple times. You may get blocked if you send in too many requests in a short period.
Make sure to include an "s" before your station ID.
Information does not update on the TuneIn.com site in realtime. Changes to station information can take up to a day to appear.
If the station is going to a commercial or other non-song playing period, send the request with the commercial=true flag.