API Methods: blogs.getList

Description

Returns a list of blogs on the site


Authentication

This method requires authentication without user credentials.

API Version

Version 1&2

Required parameters

  • None

Optional parameters

  • blog_id :
    the id number of the blog
  • user_id :
    the id number of the user who created the blog
  • name :
    the name of the blog
  • description :
    a brief description of the blog
  • total_subscribers :
    the total number of users who are subscribed to the blog
  • total_bloggers :
    the total number of users who contribute to the blog
  • total_posts :
    the total number of posts to the blog
  • last_post_date :
    the date of the last blog post formatted as a Unix time stamp
  • ss_key :
    the key of the community associated with the blog. The list of communities is available from the communities.getList call.
  • interest_key :
    the key of a site interest associated with the blog. The list of interests is available from the siteinterests.getList call.
  • subinterest_key :
    the key of a site sub-interest associated with the blog. The list of interests is available from the siteinterests.getList call.

Example response

<?xml version="1.0"?>
<response status="ok" time="Fri, 18 Apr 2008 12:53:49 -0500">
    <blogs count="2" total="2">
        <blog>
            <blog_id>1</blog_id>
            <user_id>25</user_id>

            <name>
                <![CDATA[Rod Thoughts]]>
            </name>
            <description/>
            <total_subscribers/>
            <total_bloggers>1</total_bloggers>

            <total_posts>1</total_posts>
            <last_post_date>1196276864</last_post_date>
        </blog>
        <blog>
            <blog_id>2</blog_id>

            <user_id>8</user_id>
            <name>
                <![CDATA[Test blog with a long description]]>
            </name>
            <description>

                <![CDATA[Four score and seven years ago our fathers brought forth on this continent a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.
                
                Now we are engaged in a great civil war, testing whether that nation, or any nation, so conceived and so dedicated, can long endure. We are met on a great battle-field of that war. We have come to dedicate a portion of that field, as a final resting place for those who here gave their lives that that nation might live. It is altogether fitting and proper that we should do this.
                
                But, in a larger sense, we can not dedicate√¢ÔøΩÔøΩwe can not consecrate√¢ÔøΩÔøΩwe can no]]>
            </description>
            <total_subscribers/>
            <total_bloggers>2</total_bloggers>
            <total_posts>3</total_posts>

            <last_post_date>1196809591</last_post_date>
        </blog>
    </blogs>
</response>