current apps

Overview

What is RSS?
RSS is a simple, standardized data feed format that many web services use to allow sharing of frequently updated collections of content, such as blog entries, news headlines, audio, and video.

How to I access RSS Feeds on Current?
Most Current.com pages have corresponding RSS feeds that you can access by clicking the RSS icon in your browser's address bar. Here's how it looks in Firefox (it's the orange icon at the right). Some browsers display the RSS icon using a different color.

What about video RSS Feeds?
Current's RSS feeds are RSS 2.0 compliant, utilizing Media RSS extensions. We include video media via our player when a playable video exists - according to the MRSS specification. Note: There is no difference between typing .rss or .mrss in one of our feed URL's - either will serve up the same Media RSS feed.

What if I want a custom RSS Feed?
In addition to the feeds linked from a page's address bar, you can create customized feeds of most Current.com item collections and user activity. Below is a detailed description of our feed URL formats and available options for customization.

I don't see all the available items in the feed I selected. Why?
To keep data payloads manageble, most of the RSS feeds below only return 20 items per request. If you want to see more items from a given feed, check to see if the feed supports virtual pagination via the "page" argument. Most of our feeds do. See the examples below for more information.

Available Feeds

• Homepage
• TV Schedule
• Items
• Groups
• Tags
• User Activity
• Item Comments
• Search
• Recent Video

Homepage

Returns a feed combining all the items you see on our homepage. Your one-stop feed for keeping up with the best of Current TV and Current.com!

• URL Format: /homepage/locale.rss
• Required Arguments
  • locale = en_US,en_GB,it_IT
• Optional Arguments
  • none
• Examples:

http://feeds.current.com/homepage/en_US.rss
http://feeds.current.com/homepage/en_GB.rss
http://feeds.current.com/homepage/it_IT.rss

TV Schedule

Returns a feed of the upcoming programming schedule on Current TV.

• URL Format: /homepage/locale.rss
• Required Arguments
  • locale = en_US,en_GB (not available in Italy)
• Optional Arguments
  • start = URL-encoded RFC-822 date
  • end = URL-encoded RFC-822 date
• Examples:

http://feeds.current.com/tv_schedule/en_GB.rss
http://feeds.current.com/tv_schedule/en_US.rss
http://feeds.current.com/tv_schedule/en_US.rss
?start=Tue%2C%2004%20May%202010%2020%3A00%3A00%20%2B0000
&end=Wed%2C%2005%20May%202010%2020%3A00%3A00%20%2B0000

Items

Return feeds of the last 2 weeks of items on Current.com, sorted by various filters.

• URL Format: /items/filter.rss
• Required Arguments
  • filter = string identifying an view filter. Valid options are:
    • newest = the most recently added items on Current.com
    • popular = the most popular items on Current.com right now, according to our scoring algorithm
    • votes = the most voted-up items on Current.com over the last 2 weeks
    • views = the most viewed items on Current.com over the last 2 weeks
    • comments = the most commented-on items on Current.com over the last 2 weeks
  • Optional Arguments
    • page = number
  • Examples:

  http://feeds.current.com/items/newest.rss
  http://feeds.current.com/items/popular.rss
  http://feeds.current.com/items/votes.rss
  http://feeds.current.com/items/views.rss
  http://feeds.current.com/items/comments.rss

  
  

  Groups

  Returns items associated with a given group, newest first. Supports pagination. No special treatment is given to featured items – they are returned inline with regular items.

  • URL Format: /c/slug.rss
  • Required Arguments
    • slug = alphanumeric string identifying a group (may also contain forward slashes)
  • Optional Arguments
    • page = number
  • Example with all possible arguments:

  http://feeds.current.com/c/comedy.rss?page=2
  http://feeds.current.com/c/shows/vanguard.rss
  http://feeds.current.com/c/groups/high-speed-rail.rss

  
  

  Tags

  Returns items tagged with a given tag, newest first. Supports pagination.

  • URL Format: /tags/id.rss
  • Required Arguments
    • id = integer identifying a tag
  • Optional Arguments
    • page = number
  • Example with all possible arguments:

  http://feeds.current.com/tags/88919583.rss?page=3

  
  

  User Activity

  Returns items associated with user activity. Newest items first. Supports pagination.

  • URL Format: /user/username/filter.rss
  • Required Arguments
    • username = string identifying a user
    • filter = string identifying an activity filter. Valid options are:
      • all = all username's activity (really an optional parameter, '/user/username.rss' is a shortcut to this filter)
      • badges = all videos submitted by username
      • follows = all groups and users username is following
      • submissions = all items submitted by username
      • comments = all items username has commented on
      • votes = all items username has voted up
  • Optional Arguments
    • page = number
  • Examples:

  http://feeds.current.com/user/ctv/all.rss?page=2
  (or http://feeds.current.com/user/ctv.rss)
  http://feeds.current.com/user/ctv/badges.rss?page=2
  http://feeds.current.com/user/ctv/follows.rss?page=2
  http://feeds.current.com/user/ctv/submissions.rss?page=2
  http://feeds.current.com/user/ctv/comments.rss?page=2
  http://feeds.current.com/user/ctv/votes.rss?page=2

  
  

  Item Comments

  Most recent or most popular comments on on given item.

  • URL Format: /item/id/comments/filter.rss?page=2
  • Required Arguments
    • id = number identifying an item.
    • filter = string identifying a sorting filter. Valid options are:
      • 'popular' = The most popular comments on the item
      • 'newest' = The newest comments on the item
  • Optional Arguments
    • page = number
  • Examples: (Sample Item URL: http://current.com/items/92259473_map-of-every-fast-food-hamburger-in-america.htm)

  http://feeds.current.com/item/92259473/comments/popular.rss
  http://feeds.current.com/item/92259473/comments/newest.rss?page=2
  

  
  

  Search

  Returns items associated with a search query and given search parameters. Supports pagination.

  • URL Format: /search.rss?q=query
  • Required Arguments
    • query = string to search for
  • Optional Arguments
    • s = search "stories" (a.k.a items) 1 = true, 0 = false, defaults to 1
    • v = search "videos" (a.k.a items with video assets) 1 = true, 0 = false, defaults to 1
    • sort = one of "newest" or "popular" (a.k.a. "best match"), defaults to "newest"
    • locale = one of "en_US","en_GB","it_IT" – when supplied, limits searches to items posted in that locale only. defaults to no locale filtering.
    • page = number
  • Examples:

  http://feeds.current.com/search.rss?q=Obama
  (all possible items matching "Obama" newest first)
  http://feeds.current.com/search.rss?q=Obama&s=0&v=1
  (just videos matching "Obama", newest first)
  http://feeds.current.com/search.rss?q=Obama&s=0&v=1&locale=en_US
  (just videos posted in the US matching "Obama", newest first)
  http://feeds.current.com/search.rss?q=Obama&s=1&v=1&sort=popular
  &locale=en_US&page=2
  (all possible arguments)

  
  

  Recent Video

  Returns items with current-hosted video assets from all users during the past 24 hours.

  • URL Format: /videos.rss
  • Required Arguments
    • none
  • Optional Arguments
    • none
  • Example with all possible arguments:

  http://feeds.current.com/videos.rss

  
  

  Have questions or comments? Visit our feedback page.