API Methods: blogs.getPosts

Description

Returns a list of blog posts and any comments for these posts.

Authentication

This method requires authentication without user credentials.

API Version

Version 1&2

Required parameters

  • None

Optional parameters

  • blog_id :
    the id of the blog containing the post. The list of blogs is available from the blogs.getList call.
  • user_id :
    the id of the user who made the post. The list of users is available from the users.getList call.
  • post_id :
    the id number of the blog post
  • date_posted :
    the date of the blog post formatted by RFC 822 specifications
  • subject :
    the subject of the blog post
  • body :
    the body of the blog post. There is a string inserted into the post which marks the divider between the short and long bodies of the post: 371d36d75e05eda735858f8e467be99c. This string should be removed when displaying the blog post.
  • allow_comments :
    this is a boolean value (1=true, 0=false) which determines if readers can post comments on this blog post
  • ss_key :
    the key of the community associated with the blog post. The list of communities is available from the communities.getList call.
  • interest_key :
    the key of a site interest associated with the blog post. The list of interests is available from the siteinterests.getList call.
  • subinterest_key :
    the key of a site sub-interest associated with the blog post. 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:57:21 -0500">
    <blog_posts count="2" total="4">
        <blog_post>
            <blog_id>1</blog_id>
            <post_id>1</post_id>

            <user_id>25</user_id>
            <date_posted>
                <![CDATA[Wed, 28 Nov 2007 13:07:44 -0600]]>
            </date_posted>
            <subject>

                <![CDATA[test]]>
            </subject>
            <body>
                <![CDATA[test<br />371d36d75e05eda735858f8e467be99ctest<br />]]>
            </body>

            <allow_comments>1</allow_comments>
            <comments count="1">
                <comment>
                    <user_id>25</user_id>
                    <comment_id>1</comment_id>

                    <body>
                        <![CDATA[test]]>
                    </body>
                </comment>
            </comments>
        </blog_post>

        <blog_post>
            <blog_id>2</blog_id>
            <post_id>2</post_id>
            <user_id>8</user_id>

            <date_posted>
                <![CDATA[Tue, 04 Dec 2007 17:06:31 -0600]]>
            </date_posted>
            <subject>
                <![CDATA[Second post]]>
            </subject>

            <body>
                <![CDATA[Our anonymous confessor has been in airline public relations, marketing, and customer relations for a decade now.<br />
                <br />Complaints Executives are concerned about the company's image, and the most effective complaints go right to the top with threats of talking to the media or the Department of Transportation. These complaints are handed off to someone like me, whose job is to make you feel better--in the form of free tickets, if you're lucky.371d36d75e05eda735858f8e467be99cRefunds and changes I'll never get those travelers who buy nonrefundable tickets and then give the airline a hard time because they can't have a refund. If you must change plans, you can request that a reservation agent waive a fee, but it's unlikely you'll get anywhere. Agents try as hard as an NFL defense to hold the line. We will, perhaps, waive change fees if there was a death in the family, you're horribly sick or under military orders, or you encountered a flash flood or some other disaster on the way to the airport. But don't be surprised when we ask you to prove your situation.<br />
                <br />Lost luggage Airlines anticipate that about 1 percent of checked bags will be mishandled, damaged, or lost, and they even budget accordingly. The maximum that domestic airlines have to pay for damaged or delayed bags is $3,000 per passenger, as per the Department of Transportation. But airlines hardly ever pay anywhere near that amount because they don't reimburse for cash, cameras, video equipment, computers, jewelry, antiques, or other expensive stuff. <br />]]>

            </body>
            <allow_comments>1</allow_comments>
        </blog_post>
    </blog_posts>
</response>