Hint: open the JavaScript console in this tab to see the logged feed object (^_-)-☆

For the former Google API users

feednami.loadGoogleFormat replicates the Google Feed API as best as it can. For example, the content attribute of an entry corresponsds to <content>, <summary>, or <description>, whereas by default, all three are returned with the unset values as null.

title The feed title. Corresponds to the <title> element in Atom and the <title> element in RSS.

link The URL for the HTML version of the feed. Corresponds to the <link> element in Atom and the <link> element in RSS.

description The feed description. Corresponds to the <subtitle> element in Atom and the <description> element in RSS.

author The feed author. Corresponds to the <name> element for the author in Atom.

entries[] A list of all of the entries in the feed. Corresponds to the <entry> element in Atom and the <item> element in RSS.

mediaGroup A container for Media RSS feed results. All result properties nested under mediaGroups correspond exactly as documented in the Media RSS Specification. Media RSS is available only for feed entries newer than February 1st, 2010. Please refer to that specification for detailed information about Media RSS fields.

title The entry title. Corresponds to the <title> element in Atom and the <title> element in RSS.

link The URL for the HTML version of the entry. Corresponds to the <link> element in Atom and the <link> element in RSS.

content The body of this entry, inlcuding HTML tags. Since this value can contain HTML tags, you should display this value using elem.innerHTML = entry.content (as opposed to using document.createTextNode). Corresponds to the <content> or <summary> elements in Atom and the <description> element in RSS.

contentSnippet A snippet (< 120 characters) version of the content attribute. The snippet does not contain any HTML tags.

publishedDate The string date on which the entry was published of the form "13 Apr 2007 12:40:07 -0700". You can parse the date with new Date(entry.publishedDate). Corresponds to the <published> element in Atom and the <pubDate> element in RSS.

categories[] A list of string tags for the entry. Corresponds to the term attribute for the element in Atom and the <category> element in RSS.

Compatibility

Promises

Feednami uses Promises, but does not include the polyfill by default. If you want to support IE and older browsers, call feednami.loadPolyfills(callback) before loading any feeds.

Example

Migrating from v1 to v1.1

The v1.1 library should be backwards compatible with the v1 API (i.e. callback support), so you shouldn't have to change any of your existing code. If you were using the previous version and you are having issues, send Ricky an email.

Credits

Thanks to the contributors of Feedparser for helping power the backend!