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 BeyondWords and convert it into audio. You can then automatically 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 BeyondWords 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 Player can use this to match audio assets in your BeyondWords 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 Player code can use this to match match audio assets in your BeyondWords 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 — BeyondWords 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 BeyondWords

  1. Sign into your BeyondWords account (don't have one? Create your free account)

  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 (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

  3. Select 'Save changes'

BeyondWords will now import content from your RSS feed and convert it into audio, with each conversion using characters. 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 characters.


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

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

If you wish to edit the audio script without editing your text post, see our instructions on editing audio.


How do I distribute my audio assets?

You can automatically embed audio versions alongside text versions via our Small Player.

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

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

You can also share a 'latest audio' playlist.



Did this page help you?