Return to Developer Console

Feed Items

Retrieve Feed Items

Feed Items are returned from newest to oldest based on the time they were created in the system.
https://feedwrangler.net/api/v2/feed_items/list
Name Required Notes
access_token YES
read NO true or false, filter based on read status.
starred NO true or false, filter based on starred status.
feed_id NO Only return feed_items from within a particular feed.
created_since NO Unix timestamp after which to return feed_items
updated_since NO Unix timestamp after which to return feed_items that have changed
limit NO Maximum number of items to return, default 100, max 100
offset NO Number of items to skip before returning results, default 0
Success:
{
    "count":2,
    "feed_items":
        [
            {
                "feed_item_id":8046,
                "published_at":1367362441,
                "created_at":1367416779,
                "version_key":1367864007,
                "updated_at":1367864007,
                "url":"https://medium.com/what-i-learned-building/9216e1c9da7d",
                "title":"The McDonald’s Theory of Bad Ideas",
                "starred":false,
                "read":true,
                "read_later":false,
                "body":"...",
                "author":"John Gruber",
                "feed_id":290,
                "feed_name":"Daring Fireball"
            },
            {
                "feed_item_id":8045,
                "published_at":1367380295,
                "created_at":1367416779,
                "version_key":1367867655,
                "updated_at":1367867655,
                "url":"http://daringfireball.net/2013/04/web_apps_native_apps",
                "title":"★ Web Apps vs. Native Apps Is Still a Thing",
                "starred":true,
                "read":true,
                "read_later":false,
                "body":"...",
                "author":"John Gruber",                
                "feed_id":290,
                "feed_name":"Daring Fireball"
            }
        ],
    "error":null,
    "result":"success"
}

Retrieve Feed Item Ids

The IDs of the feed Items that match the request criteria
https://feedwrangler.net/api/v2/feed_items/list_ids
Name Required Notes
access_token YES
read NO true or false, filter based on read status.
starred NO true or false, filter based on starred status.
feed_id NO Only return feed_items from within a particular feed.
created_since NO Unix timestamp after which to return feed_items
updated_since NO Unix timestamp after which to return feed_items that have changed
published_since NO Unix timestamp after which to return feed_items that have changed
limit NO Maximum number of items to return, default 1000, max 1000
offset NO Number of items to skip before returning results, default 0
NOTE:

If you query this endpoint with the created_since, updated_since, and/or published_since filters, then the corresponding timestamp is also returned along with the id.
Success (no timestamp filters):
{
    "count":3,
    "feed_items":
    [
        {
            "feed_item_id":8194
        },
        {
            "feed_item_id":8192
        },
        {
            "feed_item_id":8190
        }
    ],
    "error":null,
    "result":"success"
}
Success (published_since timestamp filter used):
{
    "count":3,
    "feed_items":
    [
        {
            "feed_item_id":8194,
            "published_at":1367873228
        },
        {
            "feed_item_id":8192,
            "published_at":1367884744
        },
        {
            "feed_item_id":8190,
            "published_at":1367890045
        }
    ],
    "error":null,
    "result":"success"
}

Return the IDs of feed_items that have been updated.

https://feedwrangler.net/api/v2/feed_items/changed
Name Required Notes
access_token YES
updated_since YES Unix timestamp of the earliest change to return
read NO true or false, filter based on read status.
starred NO true or false, filter based on starred status.
Success:
{
    "count":2,
    "feed_items":
        [
            {
                "feed_item_id":8194,
                "updated_at":1367960870
            },
            {
                "feed_item_id":8045,
                "updated_at":1367940419
            }
        ],
    "error":null,
    "result":"success"
}

Return the a specific collection of feed_items by ID

https://feedwrangler.net/api/v2/feed_items/get
Name Required Notes
access_token YES
feed_item_ids YES Comma separated list of feed_item_id values. For Example, "8194,8045"
Success:
{
    "count":2,
    "feed_items":
    [
        {
            "feed_item_id":8194,
            "published_at":1367873228,
            "created_at":1367956808,
            "version_key":1367960870,
            "updated_at":1367960870,
            "url":"http://blogs.adobe.com/creative-cloud-members-coming-soon.html",
            "title":"Photoshop CC",
            "starred":true,
            "read":true,
            "read_later":true,
            "body":"...",
            "author":"John Gruber",
            "feed_id":290,
            "feed_name":"Daring Fireball"
        },
        {
            "feed_item_id":8045,
            "published_at":1367380295,
            "created_at":1367416779,
            "version_key":1367940419,
            "updated_at":1367940419,
            "url":"http://daringfireball.net/2013/04/web_apps_native_apps",
            "title":"★ Web Apps vs. Native Apps Is Still a Thing",
            "starred":true,
            "read":true,
            "read_later":false,
            "body":"...",
            "author":"John Gruber",
            "feed_id":290,
            "feed_name":"Daring Fireball"
        }
    ],
    "error":null,
    "result":"success"
}

Search for Feed Items

Feed Items are returned from newest to oldest based on the time they were created in the system.
https://feedwrangler.net/api/v2/feed_items/search
Name Required Notes
access_token YES
search_term YES String to match for the search
limit NO Maximum number of items to return, default 100, max 100
offset NO Number of items to skip before returning results, default 0
Success:
{
    "count":1,
    "feed_items":
        [
            {
                "feed_item_id":8045,
                "published_at":1367380295,
                "created_at":1367416779,
                "version_key":1367867655,
                "updated_at":1367867655,
                "url":"http://daringfireball.net/2013/04/web_apps_native_apps",
                "title":"★ Web Apps vs. Native Apps Is Still a Thing",
                "starred":true,
                "read":true,
                "read_later":false,
                "body":"...",
                "author":"John Gruber",
                "feed_id":290,
                "feed_name":"Daring Fireball"
            }
        ],
    "error":null,
    "result":"success"
}


Update Feed Item

Update a feed_item's read, starred, or read_later status. You can update all three statuses at the same time if desired.
https://feedwrangler.net/api/v2/feed_items/update
Name Required Notes
access_token YES
feed_item_id YES
read NO true or false
starred NO true or false
read_later NO true or false
Success:
{
    "feed_item": {
        "feed_item_id":8045,
        "published_at":1367380295,
        "created_at":1367416779,
        "version_key":1367867655,
        "updated_at":1367867655,
        "starred":true,
        "read":true,
        "read_later":false,
        "feed_id":290
    },
    "error":null,
    "result":"success"
}

Mark Multiple Feed Items as Read

https://feedwrangler.net/api/v2/feed_items/mark_all_read
Name Required Notes
access_token YES
feed_id NO Only update feed_items within a particular feed
created_on_before NO Unix timestamp to limit the application to items created on or before.
feed_item_ids NO Comma separated list of feed_item_id values. For Example, "8194,8045"
Success:
{
        "count":1,
        "feed_items":
        [
            {
                "feed_item_id":8045,
                "published_at":1367380295,
                "created_at":1367416779,
                "version_key":1367940419,
                "updated_at":1367940419,
                "starred":true,
                "read":true,
                "read_later":false,
                "feed_id":290
            }
        ]
    ,"error":null,
    "result":"success"
}


Developer Inquiries