RSS Feed | Rumble Inc. 

Rss Feed

RssOptimizing Your RSS Feed
For Rumble

General

This document describes the technical requirements and best practices for optimal integration of your RSS feeds with the Rumble platform.

Please note that your RSS feed will need to contain all of the following before being featured by Rumble:

1) The entire body copy of your article, on top of headlines and summaries.

2) If there is an image attached to the article, it should be greater than 400px in width.

In order to simplify the integration into Rumble platform, Rumble has leveraged the following widely-adopted open standards:

  • RSS: The standard syndication format for content on the web. Full-text RSS feeds, where the entire content of the article is included within the feed, are required.
  • Media RSS: Assets such as images, video, and audio are included using this standard extension to RSS.

Feed Structure

Article Items

Mandatory Elements

Each <item> within a feed represents an article. At a minimum, the <item> must include the following elements:

  • <guid>: The String that uniquely identifies the item (The item unique url).
  • <link>: The canonical URL for the article.
  • <title>: The article’s headline.
  • <pubDate>: The item publication/creation date, in RFC822 format.
  • <content:encoded>: The full HTML content of the article (See <media:content> section)

Optional (recommended) Elements

The <item> may include the following elements, they are not required, but highly recommended:

  • <description>: A short, plain-text summary or abstract of the article (subtitle).
  • <dc:creator>: Name of the author of the article.
  • <media:content>: Element for syndicating media content (See <media:content> section)
  • <media:description>: Description of the media content
  • <media:credit>: A credit for an important entity like Author/Photographer.
  • <media:price>: Optional tag to include pricing information about the item

Important notes

<content:encoded>

<content:encoded> element must contain the entire HTML contents of an article. All HTML must be properly escaped; the recommended way to do this is by wrapping the content within a CDATA section.

<description>

  • This element serves as the item subtitle, the element should contain plain-text.
<description>The young singing sensation is expected to take the stage Oct. 15 at the  County Coliseum, officials confirmed today.</description>

<dc:creator>

  • The person or entity who wrote the article.
<dc:creator><![CDATA[Some awesome author]]></dc:creator>

<media:content>

  • Add this element if you want your article to be represented by a media content like an image.
  • This element can only be sub-element of <item> element.
  • This element can have multiple instances, order is important, first instance will act as item representative.
  • Supported image types are PNG, JPG, GIF
  • This element has 2 required attribute and 2 optional attributes.
    url (Required): specifies the url of the image.
    type (Required): specifies standard MIME type of the item. Supported values: “image/jpg”, “image/png”, “image/gif”
    height (Optional): specifies the height of the thumbnail. It is an optional attribute.
    width (Optional): specifies the width of the thumbnail. It is an optional attribute.
<media:content url="http://www.rumble.me/somepicture.jpg" type="image/jpeg" height="475" width="654"><media:description type="html"><![CDATA[Very rare image!]]></media:description></media:content>

<media:description>

  • Short description describing the media object, typically a sentence in length.
  • This element can only be sub-element of <media:content> element.
<media:description>This was some really bizarre band I listened to as a young lad.</media:description>

<media:credit>

  • Add this element if a credit is needed for the media content.
  • This element can only be sub-element of <media:content>
  • This element has 1 required attribute.
    role (Required): specifies the role the entity played, must be lowercase.
  • There should be at most ONE <media:credit> element per role.
  • Supported values: “photographer”
<media:credit role="photographer">great photographer</media:credit>

<media:price>

  • Optional tag to include pricing information about an item. The presence of this tag would mean that this item is not free. Otherwise, the item is supposed to be free.
  • Use this element if marking the item as “premium” is required.
  • This element can only be sub-element of <item>
<media:price />

Feed example with one item:

Below is a sample of an RSS 2.0 feed with two stories:

<rss version="2.0"xmlns:content="http://purl.org/rss/1.0/modules/content/"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:media="http://search.yahoo.com/mrss/"xmlns:atom="http://www.w3.org/2005/Atom"xmlns:georss="http://www.georss.org/georss"><channel><title>The Springfield Shopper</title><link>http://example.com/</link><description>Your daily source for local Springfield news, sports, and weather</description><language>en-us</language><atom:link rel="hub" href="http://pubsubhubbub.appspot.com"/><item><title>Squirrel Resembling Abraham Lincoln Found</title><link>http://example.com/1992/01/09/squirrel-resembling-abraham-lincoln-found</link><guid>2fd4e1c67a2d28fced849ee1bb76e7391b93eb12</guid><pubDate>Tue, 10 Jun 2003 04:00:00 GMT</pubDate><dc:creator>Ralph Wiggum</dc:creator><georss:point>45.256 -71.92</georss:point><description><![CDATA[A local Springfield man has restored pride to Springfield by finding a squirrelthat resembles Abraham Lincoln. Authorities are on the lookout for any rodentsbearing resemblance to John Wilkes Booth.]]></description><content:encoded><![CDATA[<p>Full content of the article <em>goes here</em>.</p><figure><img src="http://media.example.com/1992/01/09/squirrel.jpg" width="1200" height="900"><figcaption>This squirrel bares a strong resemblance to <strong>Abraham Lincoln</strong><span class="copyright">Carl Carlson</span></figcaption></figure><p>Images and videos should be placed within the article copy.</p><figure><video width="1200" height="900"><source src="http://media.example.com/1992/01/09/squirrel-lincoln.mp4.jpg" type="video/mp4"></video><figcaption>Kent Brockman interviews the squirrel on location<span class="copyright">Carl Carlson</span></figcaption></figure><p>More content goes here ...</p>]]></content:encoded></item><item><title>Burns Pays City 3 Mil!</title><link>http://example.com/1993/01/14/burns-pays-city-3-mil</link><guid>de9f2c7fd25e1b3afad3e85a0bd17d9b100db4b3</guid><pubDate>Tue, 10 Jun 2003 04:00:00 GMT</pubDate><dc:creator>Todd Flanders</dc:creator><georss:point>45.256 -71.92</georss:point><description><![CDATA[Wealthy resident Montgomery Burns was fined three million dollars afterbeing caught dumping nuclear waste in the Springfield city park.]]></description><content:encoded><![CDATA[<p>Full content of the article <em>goes here</em>.</p>]]></content:encoded></item></channel></rss>