OVERVIEW

AIR is our broadcaster API. It offers several methods to allow broadcasters and other publishers to send playlist information 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 artists or songs commonly played
  • Browse station playlist history on TuneIn mobile and TuneIn.com

Please e-mail broadcaster-support@tunein.com and provide us your TuneIn station ID and the broadcasting software you are using for permission to use the API. If your broadcasting software is found on the list of compatible solutions below or you have created a custom solution to work with our API, we will grant you a partnerId and partnerKey.

To locate your stationId, search for your station or program on TuneIn.com. From the resulting TuneIn.com URL, use the last set of digits for your stationId. For example, if your TuneIn.com URL is http://tunein.com/radio/FringeSF-s211838/, your station ID would be s211838.

BROADCAST SOFTWARE

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.

Spacial Audio's Sam Broadcaster uses the SAMRadioTime.pal script.

Broadcast Electronics' The Radio Experience includes a plugin.

LiveWebDJ's TuneIn.com API Integration Instructions can be found here

MegaSeg provides an FAQ for set up here

ProppFrexx has a topic in their message board dedicated to our API set up here

RadioJar help page for implementation is here

ShoutIRC wiki page for AIR API configure is here

Spinitron's User Guide referencing how to implement our API can be found here

Instructions for the following broadcasting software solutions can be found here:

Contact the following software solutions directly for setup support:

  • ShoutAutomation* at support@shoutautomation.com
  • Wide Orbit at radioautomationaupport@wideorbit.com

* - SHOUTcast Widgets provides a pay-for solution for broadcasters using SHOUTcast streams. You can contact SHOUTCAST Widgets support here. Please note that SHOUTCAST Widgets is a third party solution that is not affiliated with TuneIn in any way.

BASICS

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.

SPECIFICS

Input

Parameter Description
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

Output

Check the status code for success or failure result (200 means success)

NOTES

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.

Loading