Feeds

issuu supports a list of different RSS feeds

Folder feeds

Folder feeds come in two different formats: standard RSS 2.0 XML as well as an RSS 2.0 JSONP variant suitable for AJAX clients.

http://feed.issuu.com/folder/<folderId>/rss20.xml
http://feed.issuu.com/folder/<folderId>/rss20.jsonp

The JSONP callback method is defined as the string "folder" followed by the last 8 characters of the folderId.

The response formats for a folder with id 52ab7b36-946d-45b2-a446-f95e84b2682e is shown in the example below

XML

<rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:issuu="http://www.issuu.com/opensearchrss/1.0/" xmlns:media="http://search.yahoo.com/mrss/" version="2.0" issuu:id="52ab7b36-946d-45b2-a446-f95e84b2682e" issuu:type="folder">
  <channel>
    <title>Inspiration</title>
    <description>Inspiration</description>
    <link>http://issuu.com</link>
    <lastBuildDate>Tue, 21 Jul 2009 14:11:45 GMT</lastBuildDate>
    <atom:link href="http://feed.issuu.com/folder/52ab7b36-946d-45b2-a446-f95e84b2682e/rss20.xml" rel="self" type="application/rss+xml"/>
    <issuu:fields>
      <issuu:field name="username" value="travelmagazine"/>
      <issuu:field name="folderId" value="52ab7b36-946d-45b2-a446-f95e84b2682e"/>
      <issuu:field name="items" value="1"/>
    </issuu:fields>
    <item>
      <guid>http://issuu.com/issuu/docs/wildswim/1</guid>
      <title>Wild Swim: The best outdoor swims across Britain</title>
      <description>Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society.</description>
      <link>http://issuu.com/issuu/docs/wildswim/1</link>
      <pubDate>Mon, 22 Jun 2009 07:54:17 GMT</pubDate>
      <content:encoded>
        &lt;table&gt;&lt;tr valign="top"&gt;&lt;td width="65"&gt;&lt;a href="http://issuu.com/issuu/docs/wildswim"&gt;&lt;img src="http://image.issuu.com/081024182207-685c30c2741047c1bbd51bf4fff8e343/jpg/page_1_thumb_medium.jpg" width="55" border="0"/&gt;&lt;/a&gt;&lt;/td&gt;&lt;td&gt;&amp;nbsp;&lt;/td&gt;&lt;td&gt;&lt;img src="http://content.issuu.com/icons/label_bookmark.png" border="0"/&gt;&lt;br/&gt;&lt;span style="font-size: 12px;"&gt;Wild Swim: The best outdoor swims across Britain&lt;br/&gt;&lt;b&gt;Bookmarked by:&lt;/b&gt; &lt;a href="http://issuu.com/travelmagazine"&gt;travelmagazine&lt;/a&gt;&lt;br/&gt;&lt;b&gt;Created by:&lt;/b&gt; &lt;a href="http://issuu.com/issuu"&gt;issuu&lt;/a&gt;&lt;br/&gt;&lt;/span&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
      </content:encoded>
      <media:content url="http://image.issuu.com/081024182207-685c30c2741047c1bbd51bf4fff8e343/jpg/page_1_thumb_large.jpg"/>
      <media:thumbnail url="http://image.issuu.com/081024182207-685c30c2741047c1bbd51bf4fff8e343/jpg/page_1_thumb_medium.jpg"/>
      <issuu:page number="1"/>
      <issuu:fields>
        <issuu:field name="title" value="Wild Swim: The best outdoor swims across Britain"/>
        <issuu:field name="type" value="bookmark"/>
        <issuu:field name="documentId" value="081024182207-685c30c2741047c1bbd51bf4fff8e343"/>
        <issuu:field name="name" value="wildswim"/>
        <issuu:field name="user" value="issuu"/>
        <issuu:field name="description" value="Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society."/>
        <issuu:field name="created" value="2009-06-22T07:54:17.000Z"/>
      </issuu:fields>
    </item>
  </channel>
</rss>

JSON

folder84b2682e({
    "title": "Inspiration",
    "description": "Inspiration",
    "link": "http://issuu.com",
    "lastBuildDate": "2009-07-21T14:11:45.000Z",
    "fields": [
        {
            "name": "username",
            "value": "travelmagazine"
        },
        {
            "name": "folderId",
            "value": "52ab7b36-946d-45b2-a446-f95e84b2682e"
        },
        {
            "name": "items",
            "value": "1"
        }
    ],
    "items": [
        {
            "guid": "http://issuu.com/issuu/docs/wildswim/1",
            "title": "Wild Swim: The best outdoor swims across Britain",
            "description": "Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society.",
            "link": "http://issuu.com/issuu/docs/wildswim/1",
            "pubDate": "2009-06-22T07:54:17.000Z",
            "page": 1,
            "fields": [
                {
                    "name": "title",
                    "value": "Wild Swim: The best outdoor swims across Britain"
                },
                {
                    "name": "type",
                    "value": "bookmark"
                },
                {
                    "name": "documentId",
                    "value": "081024182109-9280632f2866416d97634cdccc66715d"
                },
                {
                    "name": "name",
                    "value": "wildswim"
                },
                {
                    "name": "user",
                    "value": "issuu"
                },
                {
                    "name": "description",
                    "value": "Wild Swim by Kate Rew is the definitive guide to over 300 beautiful outdoor swims in rivers, lakes, tidal pools, the sea and lidos across Britain. By the founder of the Outdoor Swimming Society."
                },
                {
                    "name": "created",
                    "value": "2009-06-22T07:54:17.000Z"
                }
            ]
        }
    ]
})

Use method issuu.folders.list to obtain the folderIds for your account