THANK YOU

Your information has been submitted to our team, and someone will reach out to you shortly.

Continue

Advertising Inquiries

Select a Topic

  • Device Partners
  • Advertising Inquiries
  • Station Promotion
  • Podcast Promotion
  • Press Inquiries

Choose a Different Topic













select-icon

I work for a...

I work for a...

Audio & Media Units

Just Audio

Just Media

Experiential

All of the Above

select-icon

Promote my brand via...

Promote my brand via...

National Brand

Regional Brand

Media Agency

Creative Agency

Sales

TuneIn User Needing Help




















Broadcasters

AIR API

Broadcaster FAQ

OVERVIEW

AIR is our broadcaster API that offers several methods for broadcasters and other publishers to send playlist information to TuneIn in real-time!

When you implement AIR, your listeners will be able to:

  • Discover your station by searching for artists or songs commonly played
  • Browse station playlist history on TuneIn mobile and TuneIn.com

BROADCAST SOFTWARE

For starters, you will need your TuneIn assigned station ID. Your station ID, can be found at the end of the URL for your station page when accessing it from https://tunein.com. For example, the station ID for ‘tunein.com/radio/tuneinstation-s######/’ would be ‘s######’.

BROADCAST SOFTWARE

Some broadcasting software make it easy to use our AIR API via a plugin or with input fields specifically created for your TuneIn station Id, partnerId and partnerKey to be placed in.

Airtime Pro provides instructions for adding API credentials to their software here

Broadcast Electronics’ The Radio Experience includes a plugin that can be downloaded here

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

MegaSeg provides an FAQ for set up here

OtsAV’s now playing software can be downloaded here

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

RadioJar help page for implementation is here

ShoutIRC’s wiki page for AIR API configure is here

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

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

TuneIn Auto Post is a service unaffiliated with TuneIn that “allows you to post your Radio Stations ‘Now Playing’ songs to TuneIn”. More information can be found here

Instructions for the following broadcasting software solutions can be found here:
Arrakis
Arctic Palm’s CSRDS
DARP NG
MetaRadio*
Nextkast
P Squared Myriad
DJSoft’s RadioBOSS
Radiologik
StationPlaylist

Please have your TuneIn station ID, partner ID and partner key when contacting the following software solutions for setup support:
Wide Orbit at radioautomationaupport@wideorbit.com
NextGen Digital at support@rcsoga.com
MyAutoDJ’s SHOUTcast Widgets* at info@myautodj.com

* – denotes pay-for solutions for broadcasters

BASICS

Requests to the AIR API are very simple. An example call appears as follows…

GET http://air.radiotime.com/Playing.ashx?partnerId=&partnerKey=&id=&title=Bad+Romance&artist=Lady+Gaga

Your partnerId replaces , partnerKey replaces , and stationId, including the preliminary ‘s’ replaces . 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 name of the associated album
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. Your requests may be blocked if you send multiple requests within a short period. Make sure to include an “s” before your station ID. Information does not update on the TuneIn.com site in real-time. 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.