The 72photos API consists of an array of callable methods.

To perform an action using the 72photos API, you need to choose a calling format, send a request to its endpoint specifying a method and some arguments and you will receive a formatted response.

All request formats, listed to the right, take a list of named parameters.

The REQUIRED parameter api_key is used to specify your API Key.

The summary and arguments for each method are listed when you click on a method.

To upload images, you must send a base64 encoded string of the image to the images.uploadImages method along with some basic details for the image. Tags can also be included and multiple tags can be seperated by a comma ",".

Request Formats

• XML-RPC
  XML-RPC requests are specially formatted XML data posted to a URL. You can find out more about XML-RPC at www.xmlrpc.com/.
  
  The XML-RPC Server Endpoint URL is http://72photos.com/backend/api/
• SOAP
  SOAP requests are "envelopes" of specially formatted XML data posted to a URL. You can find out more about SOAP at www.w3.org/TR/soap/.
  
  The SOAP Server Endpoint URL is http://72photos.com/backend/api/

Response Formats

• XML-RPC
  XML-RPC requests are specially formatted XML data posted to a URL. You can find out more about XML-RPC at www.xmlrpc.com/.
  
  The XML-RPC Server Endpoint URL is http://72photos.com/backend/api/
• SOAP
  SOAP requests are "envelopes" of specially formatted XML data posted to a URL. You can find out more about SOAP at www.w3.org/TR/soap/.
  
  The SOAP Server Endpoint URL is http://72photos.com/backend/api/

Official Ruby Wrapper (coming soon!)
Use 72photos in your Rails application.

XML-RPC Javascript Client
Great for building widgets using the 72photos API.

---

Questions? Email us at support@72photos.com.

Comments

• comments.addComment

  Add comment to an image as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  image_id (Required)
  The id for the image to leave comment for.
  
  comment_text (Required)
  The comment.
• comments.editComment

  Edit comment from an image as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  comment_id (Required)
  The id of the comment.
  
  comment_text (Required)
  The comment.
• comments.deleteComment

  Delete comment as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  comment_id (Required)
  The id of the comment.
• comments.getImageComments

  Returns comments for a specified image id

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  image_id (Required)
  The id of the image you wish to get comments for.
• comments.getLatestComments

  Returns latest comments for a specified user id

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  user_id (Required)
  The id of the user you wish to get comments for.

Friends

• friends.addFriend

  Add friend as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  friend_id (Required)
  The user of the person you wish to add as a friend.
  
  message (Required)
  The message you wish to send with your request.
• friends.editFriend

  Edit friend as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  friend_id (Required)
  The user id of the friend.
  
  friend_type (Required)
  Type of friend, either "friend" or "family".
• friends.deleteFriend

  Delete friend as the currently authenticated user.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  friend_id (Required)
  The user id of the friend you wish the delete.
• friends.getFriends

  Returns friends for a specified image id

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  user_id (Required)
  The id of the user you wish to get friends list for.

Galleries

• galleries.searchGalleries

  Returns a list of galleries and their details for a specified keyword

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  keywords (Required)
  The keywords you wish to search galleries for.
• galleries.getPopularGalleries

  Returns a list of popular galleries

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
• galleries.createGallery

  Creates a new gallery for the authenticated user

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  name (Required)
  Name of the gallery
  
  description (Required)
  Description of the gallery
  
  permission (Required)
  Permission for the gallery (Public, Private, Only Friends, Only Family).
• galleries.editGallery

  Edits a new gallery for the authenticated user

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  gallery_id (Required)
  The id for the gallery you wish to edit.
  
  name (Required)
  Name of the gallery
  
  description (Required)
  Description of the gallery
  
  permission (Required)
  Permission for the gallery (Public, Private, Only Friends, Only Family).
• galleries.addImageToGallery

  Adds an image to a specified gallery

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  gallery_id (Required)
  The id of the gallery to add image to.
  
  image_id (Required)
  The id of the image to add to the gallery.
• galleries.removeImageFromGallery

  Deletes a specified image from a specified gallery

  
  Authentication Required: YES
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  gallery_id (Required)
  The id of the gallery you'd like to delete an image from. image_id (Required)
  The id of the image you'd like to delete from a gallery.
• galleries.deleteGallery

  Deletes a specified gallery

  
  Authentication Required: YES
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  gallery_id (Required)
  The id of the gallery you'd like to delete.

Images

• images.uploadImages

  Uploads an image for the authenticated user, returns the image id.

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key. See here for more details.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  title (Optional)
  Title for your image.
  
  filename (required)
  The filename of the image your uploading
  
  description (Optional)
  Description for your image
  
  image (Required)
  Base64 encoded string of the image.
  
  tags (Optional)
  Tags for the image, comma delimited.
  
  permission (Required)
  Permission for the image, can be Public or Private.
• images.searchImages

  Returns a list of image ids for specified keywords

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key. See here for more details.
  
  keywords (Required)
  The keywords of images you'd like to search for.
  
  limit (Optional)
  The number of tags to return. Defaults to 25.
• images.getUserImages

  Returns a list of image ids for a specified user

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key. See here for more details.
  
  user_id (Required)
  The id of the user you'd like to get images for.
  
  limit (Optional)
  The number of tags to return. Defaults to 25.
• images.getDetails

  Returns details for a specified image

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key. See here for more details.
  
  image_id (Required)
  The keywords of images you'd like to search for.
• images.deleteImage

  Deletes a specified image

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  image_id (Required)
  The id of the image you'd like to delete.
• images.addTag

  Adds a tag to a specific image id

  
  Authentication Required: Yes
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  Your 72photos username.
  
  password (Required)
  Your 72photos password.
  
  image_id (Required)
  The id of the image you'd like to add a tag to.
  
  tag (Required)
  The name of the tag you'd like to add to an image.

Tags

• tags.getPopularTags

  Returns a list of popular tags

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  limit (Optional)
  The number of tags to return. Defaults to 25.
• tags.getImageTags

  Returns a list of tags for a specified image

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  image_id (Required)
  The id of the image you wish to get the tags for.
  
  limit (Optional)
  The number of tags to return. Defaults to 25.
• tags.getUserTags

  Returns a list of tags for a specified user

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  user_id (Required)
  The id of the user you wish to get the tags for.
  
  limit (Optional)
  The number of tags to return. Defaults to 25.
• tags.getInfo

  Returns details for a specified tag

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  tag_id (Required)
  The id of the user you wish to get the tags for.
  
  

Users

• users.findByUsername

  Returns a users ID, given their username

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  username (Required)
  The username for the user.
• users.findByEmail

  Returns a users ID, given their email

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  email (Required)
  The email for the user.
• users.getPopularUsers

  Returns a list of popular users

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
• users.getInfo

  Returns details for a specified user id

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  user_id (Required)
  The id of the user you wish to get details for.
• users.getStats

  Returns statistics for a specified user id

  
  Authentication Required: No
  
  Arguments:
  
  

  api_key (Required)
  Your API application key.
  
  user_id (Required)
  The id of the user you wish to get details for.