Return to Developer Console

Subscriptions

List current Subscriptions

https://feedwrangler.net/api/v2/subscriptions/list
Name Required Notes
access_token YES
Success:
{
    "feeds":
        [
            {
                "title":"Daring Fireball",
                "feed_id":290,
                "feed_url":"http://daringfireball.net/index.xml",
                "site_url":"http://daringfireball.net/"
            }
        ],
    "error":null,
    "result":"success"
}

Subscribe to URL

The feed will be added to the feed management queue, it may take a few seconds for it to actually appear in the list. This delay is caused by the actual retrieval of the feed.
https://feedwrangler.net/api/v2/subscriptions/add_feed
Name Required Notes
access_token YES
feed_url YES
Success:
{   
    "error":null,
    "result":"success"
}

Subscribe to URL and wait for full feed load.

The feed will be added to the feed system synchronously. This can take up to 10 seconds. You can optionally have the import automatically choose the best feed if multiple exist at the target URL. This works by taking the first feed listed on the page, unless the first feed also contains the word 'comment' in its name. If you don't enabled choose_first then a list of possible feeds will be returned if multiple exist. If only a single URL is found or the given URL is an RSS/Atom feed then that will be always chosen. The site_url field may not be set at this point as it relies on the full ingestion of the feed.
https://feedwrangler.net/api/v2/subscriptions/add_feed_and_wait
Name Required Notes
access_token YES
feed_url YES
choose_first NO true or false, Should subscribe to first feed found.
Success:
{
    "feed":{
        "title":"Cult of Mac",
        "feed_id":339,
        "feed_url":"http://cultofmac.com.feedsportal.com/c/33797/f/606249/index.rss",
        "site_url":null
    },
    "error":null,
    "result":"success"
}
Success (choose_first false with multiple):
{
    "possible_feeds":
    [
        {
            "feed_url":"http://feeds.macrumors.com/MacRumors-All",
            "title":"All Mac Rumors Headlines"
        },
        {
            "feed_url":"http://feeds.macrumors.com/MacRumors-Front",
            "title":"Front Page Only"
        },
        {
            "feed_url":"http://feeds.macrumors.com/MacRumors-Mac",
            "title":"Mac Blog Only"
        },{
            "feed_url":"http://feeds.macrumors.com/MacRumors-iPhone",
            "title":"iPhone/iOS Blog Only"
        }
    ],
    "error":null,
    "result":"success"
}

Unsubscribe from Feed

https://feedwrangler.net/api/v2/subscriptions/remove_feed
Name Required Notes
access_token YES
feed_id YES
Success:
{   
    "error":null,
    "result":"success"
}

Rename a Feed

https://feedwrangler.net/api/v2/subscriptions/rename_feed
Name Required Notes
access_token YES
feed_id YES
feed_name NO Excluding the new feed_name will reset the name to the RSS feed value.
Success:
    {
        "feeds":
            [
                {
                    "title":"test",
                    "feed_id":1,
                    "feed_url":"http://daringfireball.net/index.xml",
                    "site_url":"http://daringfireball.net/"
                }
            ],
        "error":null,
        "result":"success"
    }


Developer Inquiries