Post.ly - Posterous API

Overview

The Post.ly API lets you interact with Post.ly urls.

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

Method

URL

http://posterous.com/api/getpost

Fields

"id" - Required. Post.ly shortcode. (Example: 123abc in http://post.ly/123abc)

Response

    
      
        http://post.ly/abc123
        <link>http://sachin.posterous.com/brunch-in-san-francisco</link>
        <title>Brunch in San Francisco</title>
        <id>55</id>
        Sun, 03 May 2009 19:58:58 -0700
        0
        <body>This is the post body</body>
        sachin agarwal
        http://debug2.posterous.com/user_profile_pics/16071/Picture_1_thumb.png
        true
      
      
        image
        
          http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/IMG_0477.scaled500.jpg
          47
          333
          500
        
        
          http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/IMG_0477.thumb.jpg
          5
          36
          36
        
      
      
        audio
        http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/sheila.mp3
        10116
        Smashing Pumpkins
        Adore
        To Sheila
      
      
        video
        http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/movie.avi
        6537
        http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/movie.png
        http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/movie.flv
        http://posterous.com/getfile/files.posterous.com/sachin/DIptatiCkiv/movie.mp4
      
      0
      
        <body>This is a comment</body>
        Thu, 04 Jun 2009 01:33:43 -0700
        sachin
        http://debug2.posterous.com/user_profile_pics/16071/Picture_1_thumb.png

There will be a media element for each file on this post. Media elements have type image, audio, or video.

For images, thumb may not exist. For audio, id3 info may not exist.

Error

  <?xml version="1.0" encoding="UTF-8"?>
  <rsp stat="fail">
      <err code="2001" msg="Invalid url. Post not found" />
  </rsp>

2001 - Invalid url. Post not found
2002 - Post is private

Questions? Reach us at help@posterous.com at anytime and we'll get right back to you ASAP!