RSS Feed Importer

Automatically import content from an RSS feed and convert it into audio.

This guide explains how to use our RSS Feed Importer. This allows you to automatically import content from an RSS feed into SpeechKit and convert it into audio. You can then use the automatic Player to embed audio versions into their source pages.

You can use a single RSS feed for a whole website or a single RSS feed for each section of a website. RSS integration is faster than integrating with our API as it doesn't require any development on your side, other than structuring the RSS feed.

Structure your RSS feed

The SpeechKit RSS Feed Importer can be adapted to accommodate any RSS structure. However we suggest including specific RSS elements in the <item> structure to ensure the best outcome.

Please include the following elements in each RSS feed <item>:


<author>

This is the author of the article. This element will be stored as metadata.


<guid>

This is the globally unique identifier. The JavaScript version of the automatic Player can use this to match audio assets in your SpeechKit project with articles in your RSS feed. This allows the audio version to be automatically embedded alongside the text version.


<title>

This is the article title. This element will be processed into audio, so we recommend using HTML.


<description>

This is the article description. We recommend using HTML.


<link>

This is the article URL. The automatic Player can use this to match match audio assets in your SpeechKit project with articles in your RSS feed. This allows the audio version to be automatically embedded alongside the text version.


<pubDate>

This is the publish date. If pubDate is updated — for example, when you edit the source article — SpeechKit will automatically reprocess the audio.


<enclosure>

This refers to multimedia content such as images. These elements will not be processed into audio.


<content>

This is the body content. This element will be processed into audio, so we recommend using HTML.


Content format

Plain text is sufficient, but we recommend that the <title> and <content> elements use HTML. This is because HTML provides additional context that enables better conversion into speech synthesis markup language (SSML) and therefore better conversion into audio. We also recommend using HTML for the <description> element.

This content should ideally be in a CDATA section and include HTML:

<content><![CDATA[<p>The first paragraph text</p><p>Second paragraph text.</p>]]></content>

Or escape the contained HTML:

<content>&lt;p&gt;&lt;p&gt;The first paragraph text.&lt;/p&gt;&lt;p&gt;Second paragraph text.&lt;/p&gt;&lt;p&gt;</content>

An <item> that uses CDATA for the <title>, <description>, and <content> elements should look like this:

<item>
      <author>author</author>
      <guid>id</guid>
      <title><![CDATA[This is the article title]]></title>
      <description><![CDATA[This is the article description]]></description>
      <link>article_url</link>
      <pubDate>Thu, 01 Oct 2020 16:50:02 +0200</pubDate>
      <enclosure url="image.jpg" length="0" type="image/jpg" />
      <content><![CDATA[<p>This is paragraph one</p><p>This is paragraph 2</p><p>etc</p><div class="related_articles"></div>]]></content>                
</item>

Set up your RSS feed project on SpeechKit

  1. Sign into your SpeechKit account (don't have one? Start your free trial)

  2. Go to the 'Content' section of your project dashboard (don't have one? Create a project)

    Already created audio? You will need to navigate to 'Settings (Integration)' instead.

  3. Select 'RSS Feed Importer' under 'Connect your CMS'

  1. Select the AI voices you would like to use for titles and body content, then select 'Save changes' (please note that this will change the default voices for the API and Text-to-Speech Editor)

  2. Copy and paste your RSS feed URL into the corresponding field, then select 'Test' — you should get a 'Success' message

SpeechKit will now import content from your RSS feed and convert it into audio, with each conversion using one audio credit. Processing usually takes a few minutes. You can find your audio assets in the 'Content (Audios)' section of your project dashboard.

FAQs

Will my old articles be converted into audio?

Yes, the RSS Feed Importer will import all existing articles from your RSS feed and convert them into audio, as well as future articles. This will use audio credits (coming soon).


What happens when I update an article in my RSS feed?

If you update an article in your RSS feed, SpeechKit will automatically reprocess the audio. This usually takes just a few minutes and will not use any additional audio credits. You can check the audio status in the 'Content (Audios)' section of your project dashboard.


How do I distribute my audio assets?

To automatically embed audio versions alongside text versions, use our automatic Player. This Player will render on pages with corresponding audio.

To distribute your audio assets on podcast platforms, create a podcast feed.

You can share individual audio assets via URL, iFrame embed, or mp3.

You can also share a 'latest audio' playlist.