Get a feed of the latest posts added to all blogs

Home

Get a feed of the latest posts added to all blogs

Get the Blogs home page feed to retrieve all of the blog posts across all of the blogs hosted by the Blogs feature from most recent to oldest. You can narrow down the posts that are returned by passing parameters to the request that you use to retrieve the feed.
The home page blog is configured by the administrator during the installation of the Blogs feature. See Specify site-wide settings for Blogs in the Administering Blogs section of the information center and Configure Blogs in the Installing section of the information center for more details.

Atom API request details

Resource Description
{homepage}/feed/entries/atom The home page feed. Searches against this feed search all blog posts. You can narrow the search using the input parameters defined in Table 2. This feed uses a redirect to send the query to the appropriate blog handle.
{homepage} represents the blog handle of the blog configured to be the home page of the Blogs feature. The handle is defined when the home page blog is created by the administrator.

You can use one or more of the input parameters to limit the number of posts returned in the feed. Separate multiple parameters with an ampersand (&).

Input parameters

Parameter Description
email Internet e-mail address of the person whose blog posts you want to return.
Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in: adam_eventide%40garden.com
Do not use this parameter if Lotus Connections is configured to prevent e-mail addresses from being displayed. Use the userid parameter instead.
page Page number. Specifies the page to be returned. The first page is page 0. The value must be an integer equal or great than 0.
ps Page size. Specifies the number of entries to return per page. The value must be an integer between 1 and 50.
search Well-formed full text search query. Performs a text search of the blog posts.
since Includes in the resulting feed all entries published after a specified date. Specify the date using a date-time value that conforms to RFC3339. In addition, an uppercase "T" character must be used to separate date and time, and an uppercase "Z" character must be present in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z.
sortBy Species what value to use as the basis for organizing the entries returned in the feed. The options are:

commented

Organize the entries by the number of comments or replies it has received.

modified

Organize the entries by modification date.

recommended

Organize the entries by number of recommendations.

title

Organize the entries by title. The title used is the text that is displayed in the <title> element of each entry in the feed.

visited

Organize the entries by the number of times an entry has been visited.

Use with the sortOrder parameter to specify the order in which to display the results..
sortOrder Specifies the order in which to list the feed entries. The options are:

asc

Displays the entries in ascending order.

desc

Displays the entries in descending order.

tags Returns blog posts with the specified tags. Separate multiple tags with a plus sign (+).
userid Unique ID that represents a specific person.

Output

An Atom feed document containing the blog post entries.

Example
Input
GET /blogs/home/feed/entries/atom HTTP/1.1 Host: blogs.enterprise.acme.com:9081
Response:
HTTP/1.1 200 OK Content-Type: application/atom+xml; charset=utf-8

<?xml version="1.0" encoding="utf-8" ?> 
<feed 
 xmlns="http://www.w3.org/2005/Atom" 
 xmlns:app="http://www.w3.org/2007/app" 
 xmlns:thr="http://purl.org/syndication/thread/1.0" 
 xmlns:snx="http://www.ibm.com/xmlns/prod/sn" 
 xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" 
 xml:lang="en-US">
  <id>urn:lsid:ibm.com:blogs:entries-0cbaac59-cf8c-46b9-8c30-060759c5cc58</id> 
  <title type="text">Acme Corp Blog Site</title> 
  <subtitle type="html">General Information Blog</subtitle> 
  <link 
   rel="self" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/
    feed/entries/atom?lang=en_us" /> 
  <link 
   rel="alternate" 
   type="text/html" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog?
    lang=en_us" /> 
  <link 
   rel="replies" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/
    feed/comments/atom?lang=en_us" /> 
  <link 
   rel="media" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/
    feed/media/atom?lang=en_us" /> 
  <link 
   rel="http://www.ibm.com/xmlns/prod/sn/issues" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeBlog/feed/
    issuecategories/atom?lang=en_us" /> 
  <link 
   rel="first" 
   type="application/atom+xml" 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/
    feed/entries/atom?lang=en_us" /> 
  <openSearch:totalResults>1</openSearch:totalResults> 
  <app:categories 
   href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/
    feed/tags/atom?lang=en_us" /> 
  <updated>2009-07-30T10:02:10-04:00</updated> 
  <generator uri="http://www.ibm.com/xmlns/prod/sn" version="2.5">
   Lotus Connections - Blogs
  </generator> 
  <entry 
   xml:base="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/entry/
    blog_placeholder" 
   xml:lang="en-US">
    <id>urn:lsid:ibm.com:blogs:entry-b770e0c8-527a-4cb0-9d3a-1774502c7fed</id> 
    <title type="text">Placeholder blog entry</title> 
    <author>
      <name>Mary Litman</name> 
      <email>mlitman@us.acme..com</email> 
      <snx:userid>5adff8c0-7d67-102c-8452-e2ebc3ec5536</snx:userid> 
    </author>
    <link 
     rel="alternate" 
     type="text/html" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/entry/
      blog_placeholder?lang=en_us" /> 
    <link 
     rel="self" 
     type="application/atom+xml" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/feed/
      entry/atom?entryid=b770e0c8-527a-4cb0-9d3a-1774502c7fed&lang=en_us" /> 
    <link 
     rel="replies" 
     type="application/atom+xml" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/feed/
      entrycomments/blog_placeholder/atom?lang=en_us" thr:count="0" /> 
    <link 
     rel="http://www.ibm.com/xmlns/prod/sn/reports" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeBlog/api/
      reports/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us" /> 
    <link 
     rel="http://www.ibm.com/xmlns/prod/sn/recommendations" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/feed/
      entryrecommendations/b770e0c8-527a-4cb0-9d3a-1774502c7fed/atom?lang=en_us" /> 
    <app:collection 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/api/
      entrycomments/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us">
      <title type="text">Comment Entries</title> 
      <category 
       scheme="http://www.ibm.com/xmlns/prod/sn/collection" term="comments" /> 
      <app:categories fixed="yes" /> 
      <app:accept>application/atom+xml;type=entry</app:accept> 
    </app:collection>
    <app:collection 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/api/
      recommend/entries/b770e0c8-527a-4cb0-9d3a-1774502c7fed?lang=en_us">
      <title type="text">Recommendations</title> 
      <category 
       scheme="http://www.ibm.com/xmlns/prod/sn/collection" 
       term="recommend" /> 
      <app:categories fixed="yes" /> 
    </app:collection>
    <published>2009-07-30T10:02:09-04:00</published> 
    <updated>2009-07-30T10:02:09-04:00</updated> 
    <category term="issues" /> 
    <category term="sales" /> 
    <category term="acme" /> 
    <link 
     rel="related" 
     type="text/html" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/tags/
      issues?lang=en_us" /> 
    <link 
     rel="related" 
     type="text/html" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/tags/
      sales?lang=en_us" /> 
    <link 
     rel="related" 
     type="text/html" 
     href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/tags/
      acme?lang=en_us" /> 
    <content type="html">
      <![CDATA[ Entry: This entry has been created by the automated BVT.  It 
       is a simple, short posting to serve as a placeholder for others. 
       ]]&gt; 
    </content>
    <summary type="html">
      <![CDATA[ Entry: This entry has been created by the automated BVT.  It 
       is a simple, short posting to serve as a placeholder for others. 
       ]]&gt; 
    </summary>
    <snx:rank 
     scheme="http://www.ibm.com/xmlns/prod/sn/recommendations">0</snx:rank> 
    <snx:rank 
     scheme="http://www.ibm.com/xmlns/prod/sn/comment">0</snx:rank> 
    <snx:rank 
     scheme="http://www.ibm.com/xmlns/prod/sn/hit">2</snx:rank> 
    <source>
      <id>urn:lsid:ibm.com:blogs:entries-0cbaac59-cf8c-46b9-8c30-060759c5cc58</id> 
      <title type="text">Acme Corp Blog Site</title> 
      <link 
       type="application/atom+xml" 
       rel="self" 
       href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog/feed/
        entries/atom?lang=en_us" /> 
      <link 
       type="text/html" 
       href="https://blogs.enterprise.acme.com:9444/blogs/AcmeHomeBlog?lang=en_us" /> 
      <updated>2009-07-30T10:02:10-04:00</updated> 
    </source>
  </entry>
</feed>
Get data from all of the blogs

Related reference

Blog posting content
Recommending a blog posting

+
Search Tips | Advanced Search

Parameter	Description
email	Internet e-mail address of the person whose blog posts you want to return. Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in: adam_eventide%40garden.com Do not use this parameter if Lotus Connections is configured to prevent e-mail addresses from being displayed. Use the userid parameter instead.
page	Page number. Specifies the page to be returned. The first page is page 0. The value must be an integer equal or great than 0.
ps	Page size. Specifies the number of entries to return per page. The value must be an integer between 1 and 50.
search	Well-formed full text search query. Performs a text search of the blog posts.
since	Includes in the resulting feed all entries published after a specified date. Specify the date using a date-time value that conforms to RFC3339. In addition, an uppercase "T" character must be used to separate date and time, and an uppercase "Z" character must be present in the absence of a numeric time zone offset. For example: 2009-01-04T20:32:31.171Z.
sortBy	Species what value to use as the basis for organizing the entries returned in the feed. The options are: commented Organize the entries by the number of comments or replies it has received. modified Organize the entries by modification date. recommended Organize the entries by number of recommendations. title Organize the entries by title. The title used is the text that is displayed in the <title> element of each entry in the feed. visited Organize the entries by the number of times an entry has been visited. Use with the sortOrder parameter to specify the order in which to display the results..
sortOrder	Specifies the order in which to list the feed entries. The options are: asc Displays the entries in ascending order. desc Displays the entries in descending order.
tags	Returns blog posts with the specified tags. Separate multiple tags with a plus sign (+).
userid	Unique ID that represents a specific person.