Using my RSS feeds for iTunes or other platforms or apps

Every channel published on our site is also provided as an RSS feed. This feed allows users to follow your content with any RSS reader, but also provides an easy (and standards-based) way to publish and distribute your content via other platforms and applications.

Distributing your content via iTunes

You can easily import your channel's RSS feed into iTunes to allow any iTunes user to subscribe to your audio podcast. Unfortunately Apple does not allow any way for us to do this automagically, but luckily the process is pretty easy.   

Step 1: Install iTunes on your computer. Download it here.

Step 2: Copy the " Channel RSS" link just under the channel description of the channel you wish to publish on iTunes.

Step 3: If you click this link your web browser should open the "Submit podcast" page, or otherwise follow the directions on this article.


After submitting your RSS URL the podcast first has to be approved by Apple before becoming visible in the iTunes store. This may take up to a day or two.

NOTE: while our feeds and servers complies with all the listed requirements, publishers must setup their channels with the minimum 1400x1400 images required by iTunes!


What else can I control?

Currently the only other option that can be controlled is the audio quality of the files provided by the RSS feed.

By default our RSS feeds provide medium quality files (this is our recommended setting for iTunes publishing). However you can specify the quality level of the files by using the q=<profile> query parameter in the URL.

Available values are q=lowq=medium (default)q=high.

Using the previous example, to get a feed that provides the low quality episodes and includes iTunes tracking would be 
http://iono.fm/rss/chan/2019?client=itunes&q=low

Note that the requested quality must be available for your channel!


Using RSS for your own native application or platform

Currently we recommend that third-party developers who want to provide iono.fm content via their own platform or native application use our RSS functionality to track and follow audio content availability.

Our channel RSS feeds provides the latest source of available content for your channel in a standards-based machine-readable format.

There is a multitude of RSS parsing libraries is available for almost any language and platform, meaning you won't have to spend time developing code to interface with another custom API.

RSS output can be controlled slightly by using the above mentioned methods, for example if your app allows users to choose between quality levels.

  Tracking how much of your content was delivered via other platforms

We track and indicate iTunes generated downloads on our reports so it's not necessary to add a tracking code.  

Unless otherwise specified all other RSS traffic is just indicated as generic RSS based traffic. However, by adding an extra parameter to the URL you use to import the feed we can track content downloads coming from that application or platform.

For example, if your RSS feed URL is http://iono.fm/rss/chan/78 then just add the simple ?client={CLIENT ID} string to it before using.
For example: http://iono.fm/rss/chan/78?client=BBCAndroid

Please contact support@iono.fm to be allocated your own client string to track originating downloads.   please contact us to provide you with one. Note we will ignore any client string that is not recognised! 


Can I cache your audio files on my network or in my application ?

Native mobile and desktop apps that run on a user's device may cache retrieved audio files for offline and/or repeated playback. However, third-party developers may not cache files on their own servers for redistribution. All end-user file requests must be directly against our content network, using only the URLs provided by the RSS feed.

The RSS XML data may be cached but care must be taken to ensure the update frequency is sufficient! 


What data do I get from the RSS feed ?

All our RSS feeds complies with the RSS 2.0 spec but also includes most of the iTunes specific RSS fields. This allows your application or platform to get richer information about the content than normally allowed by vanilla RSS.

For example, the default RSS <enclosure> field doesn't include the playing time of a file, a valuable user information field. But this is already made available via the included <itunes:duration>3:03</itunes:duration> tag.

See the iTunes RSS fields article for a list of supported fields - note we currently supply all of them except the <itunes:category> field.


But I need X or Y data fields! Why RSS? Why not your own API?

Please contact us if your use case isn't covered by the data fields provided in our RSS feeds.

In the future we can and will support additional RSS XML namespaces to provide fields required by third parties. This will allow us to provide additional data without breaking existing client support.

We don't have our own API because we feel that currently RSS covers 99% of use cases for third-party developers while also making integration super easy with off-the-shelf RSS libraries.

We may in the future support a custom API to provide richer data, should it become necessary.
 

Feedback and Knowledge Base