Posting

The posting API lets you create new posts on Posterous. It is used with normal HTTP POST requests.

The media parameter can be an array of media. This includes images, audio, video, and common document formats.

This API is not yet frozen. Please let us know if you are using it.

All calls require user authentication which is done by basic HTTP authentication with a user's Posterous email address and password.

URL

• http://posterous.com/api/getsites

Fields

• None

    
      
        1
        Sachin Agarwal's Posterous
        http://sachin.posterous.com
        false
        true
        true
        50
      
    
	

The response includes a list of all sites owned and authored by this user.

URL

• http://posterous.com/api/newpost

Fields

• "site_id" - Optional. Id of the site to post to. If not supplied, posts to the user's default site
• "media" - Optional. File data for single file.
• "media[]" - Optional. File data for multiple file upload. Can be specified multiple times.
• "title" - Optional. Title of post
• "body" - Optional. Body of post
• "autopost" - Optional. 0 or 1.
• "private" - Optional. 0 or 1.
• "date" - Optional. In GMT. Any parsable format. Cannot be in the future.
• "tags" - Optional. Comma separate tags
• "source" - Optional. The name of your application or website
• "sourceLink" - Optional. Link to your application or website

    
      
        1234567
        http://post.ly/abc123
        http://sachin.posterous.com/sunday-brunch-in-san-francisco
        <title>Sunday brunch in San Francisco</title>
        true
      
    

	

URL

• http://posterous.com/api/newcomment

Fields

• "post_id" - The post id to comment on
• "comment" - The comment body

    
      
        24766
      
      
        111455
        http://post.ly/3C
        http://sachin.posterous.com/hello-world
        <title>Breakfast in sf</title>
      
    
	

Response:

  <?xml version="1.0" encoding="UTF-8"?>
  <rsp stat="fail">
      <err code="3001" msg="Invalid Posterous email or password" />
  </rsp>
	

• 3001 - Invalid Posterous email or password
• 3002 - Invalid site id
• 3003 - User does not have access to this site
• 3004 - Unable to save post
• 3006 - Invalid date
• 3007 - Invalid post id. Post not found
• 3008 - Comments disabled on this site
• 3009 - Unable to save comment

• Max size of media is 100MB