Buzznet API
Supported API Protocols
XML-RPC
SOAP
Community Wishlist
The following is a list of apps that the Buzznet Community needs:
Flash image organizer
sort images by date
sort images by drag and drop
sort images by visual timeline
iPhoto plugin
easy upload from iPhoto
Java
drag and drop upload
add/remove tags
add/edit blog post
Python
drag and drop upload
edit tags
edit blog post
Javascript
drag and drop upload
edit tags
edit blog post
Windows
drag and drop upload
edit tags
edit post
|
Buzznet API
Overview
buzznet.newPost -- create a new post
buzznet.editPost -- edit a post
buzznet.removePost -- remove a post
buzznet.newVideoPost -- create new video post
buzznet.editVideoPost -- edit a video post
buzznet.removeVideoPost -- remove a video post
buzznet.newJournalPost -- create a new journal post
buzznet.editJournalPost -- edit an existing journal post
buzznet.removeJournalPost -- remove a journal post
buzznet.newLinkPost -- create a new link post
buzznet.editLinkPost -- edit an existing link post
buzznet.removeLinkPost -- remove a link post
buzznet.getComments -- get comments on a post
buzznet.addComment -- add comment to a post
buzznet.removeComment -- remove comment from a post
buzznet.getRecentComments -- get recent comments on a gallery
buzznet.addBuzzwords -- add Buzzwords to a photo
buzznet.removeBuzzwords -- remove Buzzword from a photo
buzznet.updateProfile -- update user profile information
buzznet.addFriend -- add friend
buzznet.removeFriend -- remove a friend
buzznet.addGallery -- add a sub-gallery
buzznet.editGallery -- edit a sub-gallery
buzznet.removeGallery -- remove a sub-gallery
buzznet.addBookmark -- add a bookmark
buzznet.removeBookmark -- remove a bookmark
buzznet.getBookmarks -- get list of bookmarked photos
buzznet.getMyFriends -- get list of friends for the currently logged user
buzznet.getFriends -- get list of friends for a specified user
buzznet.getFriendsRecent -- get recent photos from a user's friends
buzznet.getMostPopular -- get popular photos on Buzznet
buzznet.getTodaysBirthdays -- get list of users whose birthday is today
buzznet.getOnlineNow -- get list of users who are currently signed in to Buzznet
buzznet.getRecentPosts -- get recent posts on Buzznet
buzznet.getFeaturedUsers -- get Buzznet featured users
buzznet.getBuzzword -- get paged list of photos for a given Buzzword
buzznet.browseBuzzwords -- get list of recent Buzzwords
buzznet.getGallery -- get paged list of photos from a gallery
buzznet.getSubGalleries -- get information on a given user's sub galleries
Blogger API
Overview
blogger.newPost - Buzznet implmentation of Blogger's newPost
blogger.editPost -- Buzznet implementation of Blogger's editPost
blogger.deletePost -- delete a post
blogger.getRecentPosts -- get list of recent posts
blogger.getUsersBlogs -- get list of sub-galleries
blogger.getUserInfo -- get basic user information
Buzznet API
The Buzznet API uses Basic HTTP authentication so calls to these interfaces should use the Buzznet username and password in the HTTP Auth. Your Buzznet API key goes in the URL as http://www.../?key=yourkey.
Endpoints:
SOAP: http://bnedit.buzznet.com/interface/soap/?key= my_api_key
- SOAP WSDL: http://bnedit.buzznet.com/interface/soap/?key= my_api_key&wsdl=true
XML-RPC: http://bnedit.buzznet.com/interface/xmlrpc/?key= my_api_key
Methods:
- buzznet.newPost(String filedata,String caption,String body,String category)
- Description: Post a new image to Buzznet
- Parameters
- filedata: base64-encoded contents of the image you're trying to post.
- caption: caption for the image
- body: body of the blog post text
- category: use empty string or a subgallery name to post the image to a subgallery
- Return: On sucess, the newly created post id, or 0 on failure
[top]
- buzznet.editPost(String entry_id, String filedata, String catpion, String body,String category)
- Description: Update an existing image post
- Parameters:
- entry_id: id of the image being edited
- filedata: contents of a file that will replace the existing image (use empty string to keep the existing file)
- caption: caption of the image
- body: body of the blog post text
- category: use empty string or a subgallery name to post the image to a subgallery
- Return: On success the entry of the post that was edited, 0 if there was a problem
[top]
- buzznet.removePost(String entry_id)
- Description: Remove an image post
- Parameters:
- entry_id: unique id of the image being removed
- Return: nothing
[top]
- buzznet.newVideoPost(Base64 filedata, String extension, String caption, String body)
- Description: create a new video post
- Parameters:
- filedata: video file encoded as a base64 string
- extension: file extension of the uploaded file (e.g. flv, mpg, avi, mov)
- caption: caption or title of the video
- body: description of the video
- Return: unique id of the video ($video_id) or 0 on failure
[top]
- buzznet.editVideoPost(String video_id, String title, String body, String access[public|private|friends])
- Description: edit an existing video post
- Parameters:
- video_id: unique id of an existing video
- title: caption or title of the video
- body: description of video
- access: privacy controls for the video. public=viewable by anyone, private=viewable by only video owner, friends=viewable by owner's friends
- Return: unique id of the video ($video_id) or 0 on failure
[top]
- buzznet.removeVideoPost(String video_id)
- Description: delete an existing video post
- Parameters:
- video_id: unique id of an existing video
- Return: 1 on success, error string on failure
[top]
- buzznet.newJournalPost(String title,String body )
- Description: creates a new journal post
- Parameters:
- title: title for journal post
- body: body of journal post
- Return: newly created unique_id ($journal_id) on success, error string on failure
[top]
- buzznet.editJournalPost(String journal_id, String title,String body )
- Description: edit an existing journal post
- Parameters:
- journal_id: unique id of journal post
- title: title for journal post
- body: body of journal post
- Return: unique_id ($journal_id) on success, error string on failure
[top]
- buzznet.removeJournalPost(String journal_id )
- Description: remove an journal post
- Parameters:
- journal_id: unique id of journal post
- Return: 1 on success, error string on failure
[top]
- buzznet.newLinkPost(String url, String title, String body, base64 thumbnail file )
- Description: create a new link post
- Parameters:
- url: destination webpage for the post
- title: title of the webpage
- body: description of the web page
- thumbnail: base64-encoded string containing the file that will be the post's thumbnail
- Return: newly created unique_id ($link_id) on success, error string on failure
[top]
- buzznet.editLinkPost(String link_id, String url, String title, String body, base64 thumbnail file )
- Description: edit an existing link post
- Parameters:
- link_id: unique id of the post being edited
- url: destination webpage for the post
- title: title of the webpage
- body: description of the web page
- thumbnail: base64-encoded string containing the file that will be the post's thumbnail
- Return: unique_id ($link_id) on success, error string on failure
[top]
- buzznet.removeLinkPost(String link_id )
- Description: remove an existing link post
- Parameters:
- link_id: unique id of the post being removed
- Return: 1 on success, error string on failure
[top]
- buzznet.getComments(String entry_id, String type)
- Description: get list of comments for a given image
- Parameters:
- entry_id: id of image
- type: [user | cat] "user"=user photo, "cat"=community photo
- Return: array of structs containing information about comment and comment
- Int entry_comment_id: id of comment
- Int entry_id: id of image post
- Int user_id: user id of commenter
- String time: time of comment (format:
YYYYMMDDHHmmSS)
- String type: type of post [user|cat]
- String name: username of commenter
- String comments: image comment
- String image: url to thumbnail of commenter profile image
[top]
- buzznet.addComment(String entry_id, String comment, String type)
- Description: add a comment to a user or community post
- Parameters:
- entry_id: id of the entry being commented
- comment: the comment you'd like to post
- type: [ user | cat ] -- "user" for user a post, "cat" for a community post
- Return: on success the unique ID of the comment, on failure 0
[top]
- buzznet.removeComment(String comment_id)
- Description: Remove either a comment that you have posted, or a comment on an image that you own.
- Parameters:
- comment_id: id of comment being removed
- Return: 1 on success, 0 on failure
[top]
- buzznet.getRecentComments(String username)
- Description: Get comments on the given user's blog from the past 48 hours
- Parameters:
- username: Buzznet user account getting comments for
- Return:
- Int entry_comment_id: unique id of comment
- Int entry_id: id of image (always a user image)
- Int user_id: user id of commenter (0 when the comment is anonymous)
- String time: time the comment was added (format: YYYYMMDDHHmmSS)
- String name: name of the commenter. (this won't always map to a user name. anonymous commenters can enter whatever they want.
- String comments: comment on the image
- String user_name: name of the commenter. if the commenter is a legit Buzznet user will be the user name. If they're anon. it will be "" empty.
- String caption: caption of the image being commented
- String url: homepage url of the commenter ("" for anonymous)
- String user_image: profile thumbnail of the commenter
- String entry_image: featured size version of the image being commented
- String permalink: permalink to the comment.
[top]
- buzznet.addBuzzwords(String entry_id, String tags, String type)
- Description: Add a Tag to a post
- Parameters:
- entry_id: id of the entry in which you're adding Tags
- tags: comma-separated string of image keywords
- type: [ user | cat ] -- "user" for user a post, "cat" for a community post
- Return: nothing
[top]
- buzznet.removeBuzzwords(String entry_id,String tag)
- Description: Remove a Tag from an image post
- Parameters:
- entry_id: id of post being edited
- tag: tag to be removed from image
- Return: 0 on failure, 1 on success
[top]
- buzznet.updateProfile(String password,String keyword,String fname,String lname,String email,String address,String city,String state,String zip,String country,String dob,String gender,String status )
- Description: update basic profile information on the current user
- Parameters:
- password: new password. leave as emtpy string keep the old pass
- keyword: email keyword for posting images. Leave empty to keep old keyword
- fname: first name
- lname: last name
- email: email address
- address: street address
- city: city
- state: state or province name
- zip: postal code or zip code
- country: 2-character country code
- dob: date of birth: format mm/dd/yyyy
- gender: [m | f | empty] m=male, f=female, or empty string
- status: string for user's single-status (e.g. dating, married, divorced, in a relationship)
- Return: nothing
[top]
- buzznet.addFriend(String username, int order)
- Description: add to friends list
- Parameters:
- username: username of the friend you're adding
- order: desired order in the friend list the user should appear
- Return nothing
[top]
- buzznet.removeFriend(String username)
- Description: remove friend from friend list
- Parameters:
- username: user name of the friend being added
- Return: nothing on failure. 1 on success
[top]
- buzznet.addGallery(String name, String title, String description, String keyword, String password)
- Description: create a subgallery
- Parameters:
- name: name of gallery. since this string is later used as part of the domain name (e.g. http://steve-mygallery.buzznet.com/) this needs to only contain letters and numbers. Any other charaters in the name, including the underscore character will result in gallery creation failure.
- title: title of gallery. This is a more verbose title for the gallery that is used to display the gallery name on various places in a user space.
- description: Brief description of the types of content in the gallery.
- keyword: Public keyword. This can be left empty. Populating this field will allow other's to post to this gallery via email using this keyword wihtout knowing the user's password.
- password: password for the gallery. Can (and should) be left empty. Allows for password-protection on a gallery so only authenticated users with that password can view the photos.
- Return: newly created gallery ID, on failure returns 0
[top]
- buzznet.editGallery(String name, String title, String description, String keyword, String password)
- Description: edit a subgallery
- Parameters:
- name: name of gallery being edited. Cannot be changed. Simply used as a key when editing sub gallery information
- title: title of gallery. This is a more verbose title for the gallery that is used to display the gallery name on various places in a user space.
- description: Brief description of the types of content in the gallery.
- keyword: Public keyword. This can be left empty. Populating this field will allow other's to post to this gallery via email using this keyword wihtout knowing the user's password.
- password: password for the gallery. Can (and should) be left empty. Allows for password-protection on a gallery so only authenticated users with that password can view the photos.
- Return: gallery_id on success, 0 on failure
[top]
- buzznet.removeGallery(String gallery_name)
- Description: remove a subgallery. This causes all the images that were previously in this gallery to be placed back into the main default gallery.
-
Parameters
- gallery_name: name of subgallery to be removed.
- Return: 1 on success, 0 on failure
[top]
- buzznet.addBookmark(String entry_id, String type, String order)
- Description: add a photo to bookmarks
- Parameters:
- entry_id: id of image to be added
- type: [ user | cat ] -- "user" for user a post, "cat" for a community post
- order: position in list to place the bookmark
- Return: newly created bookmark_id on success, 0 on failure
[top]
- removeBookmark(String entry_id, String type)
- Description:
- Parameters:
- entry_id: entry id of the post in the bookmark list
- type: [ user | cat ] -- "user" for user a post, "cat" for a community post
- Return: 0 on failure, 1 on successful removal
[top]
- buzznet.getBookmarks()
- Description: get list of current user's bookmarked blog entries
- Parameters: none
- Return: array of structs containing:
- int bookmark_id: unique id of bookmark
- int user_id: owner of the bookmarked entry (not the bookmarc owner)
- string type: user or cat
- int entry_id: id of entry
- string time: timestamp of entry (format:
YYYYMMDDHHmmSS)
- string caption: caption of the image
- string category: user subgallery name of image
- string body: body of entry
- string user: (same as blogname) name of the blog
- string url: permalink of image post
- string img_thumb: thumbnail version image url
- string img_synd: syndication version image url
- string img_feat: feat(ured) version image url
- string img_gallery: gallery version image url
[top]
- buzznet.getMyFriends()
- Description : get list of the current logged user's friends
- Parameters: none
- Return: array of structs containing:
- Int user_id: id of friend
- String user_name: userame of friend
- String signupdate: signupdate of friend (format
YYYYMMDDHHmmSS)
- String lastupdated: date the user's content was last updated (format
YYYY-MM-DD)
- String gallery_title: title of friend's main gallery
- String fname: first name
- String lname: last name
- String city: city
- String state: state or province
- String zip: zip/postal code
- String country: country code
- String dob: date of birth (format:
MM/DD/YYYY)
- String gender: m=male, f=female
- String single_status: relationship status of friend (e.g. married, single, divorced etc. user-input)
- String comments: "about me" information for user
- Int comments_off: 1=user does not allow comments, 0=user allows comments
- Int anon_comments: 1=user allows anonymous comments, 0=user does not allow anonymous comments
- String messages_off: 1=user has their private messages turned off, 0=user has private messages turned on
- String blog: url of the user's outside blog (e.g. http://www.livejournal.com/~myname/)
[top]
- buzznet.getFriends(int user_id)
- Description: get a list of friends for supplied user_id
- Parameters:
- user_id: id of user trying to get list from
- Return: array of structs containing:
- Int user_id: id of friend
- String user_name: userame of friend
- String signupdate: signupdate of friend (format YYYYMMDDHHmmSS)
- String lastupdated: date the user's content was last updated (format YYYY-MM-DD)
- String gallery_title: title of friend's main gallery
- String fname: first name
- String lname: last name
- String city: city
- String state: state or province
- String zip: zip/postal code
- String country: country code
- String dob: date of birth (format: MM/DD/YYYY)
- String gender: m=male, f=female
- String single_status: relationship status of friend (e.g. married, single, divorced etc. user-input)
- String comments: "about me" information for user
- Int comments_off: 1=user does not allow comments, 0=user allows comments
- Int anon_comments: 1=user allows anonymous comments, 0=user does not allow anonymous comments
- String messages_off: 1=user has their private messages turned off, 0=user has private messages turned on
- String blog: url of the user's outside blog (e.g. http://www.livejournal.com/~myname/)
- Int: totalbuddies: total number of friends the given user has
- String img_thumb: url to profile image (thumb size)
- String img_synd: url to profile image (synd[ication] size)
- String img_gallery: url to profile image (gallery size)
- String img_feat: url to profile image (fea[ured] size)
[top]
- buzznet.getFriendsRecent(Int user_id)
- Description: get list most recent entries from the provided user's friends list
- Parameters:
- user_id: user id of the person getting the list from
- Return: array of structs containing post information for each friend:
- Int entry_id: entry id of most recent image for friend
- Int user_id: user id of friend's friend
- String time: time of recent image (format:
YYYYMMDDHHmmSS
)
- String caption: caption of image
- String category: subgallery of image ("default" means the main gallery)
- String body: body text of post
- String user: user or category name of image gallery (e.g. marc, or nyc)
- String url: permalink url to image post
- String img_thumb: url to image (thumb size)
- String img_synd: url to image (synd size)
- String img_gallery: url to image (gallery size)
- String img_feat: url to image (feat size)
[top]
- buzznet.getMostPopular(string type [user|cat])
- Description: get top 10 most popular user or community posts of the week
- Parameters:
- type: [user | cat ] "user" for most popular user posts, "cat" for
- Return: array of structs containing image post info
- Int user_id: (when type="cat" this applies to community id, when type="user" its the gallery owner user id)
- Int entry_id: entry id of post
- String name: user or community name
- String caption: caption of image
- String body: body text of post
- String time: time of image post (format:
YYYYMMDDHHmmSS)
- Int hits: number of unique visitors to image
- String image: url to thumbnail of post
- String link: permalink to post
[top]
- buzznet.getTodaysBirthdays()
- Description: get list of users whose birthday is the current day
- Parameters: none
- Return: array of structs containing information about Buzznet users whose birthday is the current day
- String name: user name birthday boy or girl
- String user_id: id of birthday boy or girl
- String url: link to user's Buzznet home page
- String dob: date of birth of user (format: MM/DD/YYYY)
- String image : profile image url
[top]
- buzznet.getOnlineNow()
- Description: get information about last 10 users who are signed in on Buzznet.com
- Parameters: none
- Return: array of structs containing information on users who are currently signed in to Buzznet :
- Int user_id: id of user
- String user_name: user name
- String url: url to user's Buzznet page
- String image: profile image url
[top]
- buzznet.getRecentPosts(String type)
- Description: get last 12 recent posts from communities or users
- Parameters:
- type: [user | cat ] -- "user" to get recent user posts, "cat" to get recent community posts
- Return: array of structs containing image post information
- String: name: name of user or community blog
- Int user_id: id of user or community blog
- Int entry_id: image id
- String caption: image caption
- String body: body text of post
- String time: time of post (format:
YYYYMMDDHHmmSS)
- String author: user name of poster (type="cat" only)
- String category: user subgallery name "default" for main gallery (type="user" only)
- Int utime: unix timestamp of post
- String image: url to post thumbnail
- String link: permalink to post
[top]
- buzznet.getFeaturedUsers(Int numusers)
- Description: return list of users that have been hand-selected on Buzznet.
- Parameters:
- numusers: number of featured users to get
- Return: array of structs containing information about featured users :
- Int
user_id: user id of featured user
- String user_name: name of featured user
- String signupdate: date the user signed up (format:
YYYYMMDDHHmmSS)
- String lastupdated: date of last blog update (format:
YYYY-MM-DD)
- String fname: first name
- String lname: last name
- String city: city
- String state: state/province
- String zip: zip/postal code
- String country: country code
- String dob: date of birth (format: MM/DD/YYYY)
- String gender: m | f m=male, f=female
- String single_status: relationship status of user (e.g. married, single, divorced, widowed etc...)
- String url: Buzznet home page url for user
- String image: profile thumbnail url
- String description: featured user description
[top]
- buzznet.getBuzzword(String tag, Int pagesize, Int current_page_no)
- Description:
- Parameters:
- tag: image keyword
- pagesize: number of images to be returned
- current_page_no: zero-based page number to retrieve
- Return: array of structs containing paged information about images that have tag association with them. each struct contains:
- String author: user name of person who posted the image
- String entry_type: [user | cat] "user"=user post, "cat"=community post
- String entry_id: id of image
- String btime:
time the tag was added to the post (format: YYYYMMDDHHmmSS)
- String caption: caption of image
- String body: body text of post
- String img_thumb: url to image (thumb size)
- String img_synd: url to image (synd size)
- String img_gallery: url to image (gallery size)
- String img_featurl to image (feat size)
[top]
- buzznet.browseBuzzwords(Int numtags)
- Description: get list of recent Tags from the site
- Parameters:
- numtags: number of tags to retrieve
- Return: array of structs containing information about recent Tags
- String keyword: Tag
- String title: truncated version of Tag (if it's too long)
[top]
- buzznet.getGallery(String blog_name, String mode,String user_cat, Int current_pagepage, Int pagesize)
- Description: get images from a user or community gallery or user subgallery
- Parameters:
- blog_name: name of blog retrieving images from
- mode: [user | cat] "user" to get a user gallery, "cat" to get a community gallery
- user_cat: name of user subgallery (type="user" only)
- current_page: zero-based number of page retrieving images from
- pagesize: number of images to get for each page
- Return: array of structs containing image post information. Each struct contains:
- String category_id: community id (type="cat" only)
- String time: timestamp of image (format: YYYYMMDDHHmmSS)
- String caption: image caption
- String body: body text of post
- String name: name of the blog (community or user name)
- Int entry_id: image id
- Int user_id: user id of poster
- String user_name: name of poster
- String category user subgalleryname. "default" for main gallery (type="user" only)
- String img_thumb: url to image (thumb size)
- String img_synd: url to image (synd size)
- String img_gallery: url to image (gallery size)
- String img_featurl to image (feat size)
[top]
- buzznet.getSubGalleries(String username)
- Description: get subgallery information for a user
- Parameters:
- userame: userame of person trying to get the subgallery info from
- Return:
- String url: url of the subgallery
- String title: title of the subgallery
- String description: description of the subgallery
- String entry_id: id of latest image from that gallery
- String mtime: unix timestamp of latest image
- String image url to latest image thumbnail from gallery
- String name internal name of the gallery (also goes in url)
[top]
Blogger API
Buzznet has a particular implementation of the Blogger API where newPost() and editPost() take the actual content of the image as a base64-encoded string. Official Blogger API docs: http://www.blogger.com/developers/api/1_docs/
Endpoints:
XML-RPC: http://bnedit.buzznet.com/interface/blogger/
Methods
- blogger.newPost(string appkey, string blogid, string username, string password, string base64 content, string publish)
- Description: Creates a new post.
- Parameters:
- appkey: your Buzznet appkey
- blogid: name of gallery to post to. use "default" for the main gallery.
- username: Buzznet username
- password: Buzznet password
- content: base64-encoded file data. Since Buzznet does image posts put the actual content of the file into this field.
- publish (ignored)
- Return: new post id on success, 0 on failure
[top]
- blogger.editPost(String appkey, String postid, String username, String password, String content, boolean publish)
- Description: Edit a post
- Parameters:
- appkey: your Buzznet appkey
- postid: id of post being edited
- username: Buzznet username
- password: Buzznet password
- content: base64-encoded file data. Since Buzznet does image posts put the actual content of the file into this field.
- publish (ignored)
- Return: 1 on success, 0 on failure
[top]
- blogger.deletePost(String appkey, String postid, String username, String password, boolean publish)
- Description: Remove a post
- Parameters
- appkey: your Buzznet appkey
- postid: id of post being removed
- username: Buzznet username
- password: Buzznet password
- publish: (ignored)
- Return: 1 on success, 0 on failure
[top]
- blogger.getRecentPosts(String appkey, String blogid, String username, String password, int numberOfPosts)
- Description: Returns a list of the most recent posts in the system.
- Parameters
- appkey: your Buzznet appkey
- blogid: id of user getting posts from
- username: Buzznet username
- password: Buzznet password
- numberofposts: number of posts to get
- Return: on success, Array of structs containing ISO.8601 dateCreated, String userid, String postid, String content
[top]
- blogger.getUsersBlogs(String appkey, String username, String password)
- Description:
Returns a list of weblogs to which an author has posting privileges.
- Parameters:
- appkey: your Buzznet appkey
- username: Buzznet username
- password: Buzznet password
- Return: Array of structs containing String url , String blogid , String blogName
[top]
- blogger.getUserInfo(String appkey, String username, String password)
- Parameters:
- appkey: your Buzznet appkey
- username: Buzznet username
- password: Buzznet password
- Return:
String userid , String firstname , String lastname , String nickname , String email , String url
[top]
|