SmugMug's API

About

SmugMug's API allows you to read from and write to SmugMug for your own applications. You'll need an API Key to get started, and need to use REST, JSON, serialized PHP , or XML-RPC to interact with the service. SmugMug *highly* recommends using REST, JSON, or serialized PHP.

Contest

SmugMug? is running an API contest with iPhones as prizes. Click here for more details!

Accounts

Anyone building something for the SmugMug? API gets a lifetime free Pro account. Simply drop us a note letting us know what your application will do and a link to some of your prior work.

Already have an account? No worries, we'll convert it to free!

Want to play around first? Just sign up for our free trial and play with the API to your heart's content.

Commercial Applications

Commercial applications are not only allowed, but encouraged! We're thrilled that you want to build your business on top of SmugMug. The few exceptions include applications which try to re-sell SmugMug as their own service or product ('SmugMug-in-a-box') or commercial applications that treat SmugMug as a database server (such as an ad server). When in doubt, contact us for clarification.

User-Agent

IMPORTANT: Please send along your own custom User-Agent string on all requests, including version number, so we can help our customers out who might be using your application. Thanks!

Feeds

Often, if you just want to read data and not write it, it's often easier to just grab and parse one of our feeds. Sorry the documentation is a little weak, do feel free to ask on dgrin about more details (or even write up a better page yourself!).

Uploading

We have a special page on uploading photos to SmugMug since that can be a little confusing.

Documentation

And, of course, we have documentation on all of the SmugMug API methods. Current versions are:

• Release - 1.2.0
• Beta - 1.2.1 (see this dgrin thread until documentation has been updated)

Updates

• The official SmugMug API blog
• The API Announce mailing list

Discussion

• The Digital Grin (dgrin) API message forum
• The API Discussion mailing list

Future

• Looking for a new feature? Check the SmugBugs? and the API Feature Requests page and add it.

Toolkits & frameworks

• Riyad Kalla's Java API
• Colin Seymour's PHP wrapper, phpSmug
• SmugMug.rb - SmugMug API wrapper in Ruby

!

Applications using the API

• Adobe Photoshop Elements 5
• Adobe Photoshop Elements 4.0 -for those who have not upgraded to 5.0!
• Lightroom export plugin for SmugMug
  
• Picasa Uploader to SmugMug -Picasa plugin
  
• Star*Explorer
• Send to SmugMug
• Holocore PictureSync excellent uploader, Mac & Win Friendly
• Fotofox - Firefox extension
• SmugBrowser beta - Firefox/Flock extension
• SmugSSP - SmugMug/SlideShowPro integration
• SmuggLr - for photo sharing refugees
• UpShot
• SmugExport - Aperture plugin
• AlbumFetcher - Download galleries with embedded metadata
• WalkingBoss- Mashup your Smugmug photos on a map
• Wordpress Plug-in For Smugmug :)
• WordPress Plugin: Last Public Album for Smugmug: Get the last public album of any smugmug.com
• ApertureToSmugMug
• SmugTools Gallery Copier
• smugmugRSS - a WordPress Plugin for Smugmug based on FlickrRSS
• F-Spot - a full-featured personal photo management application for the GNOME desktop
• JSmug - A component extention for the open source CMS Joomla
• Phixr - The Online Photo Editor
• IMSmugTools - IMatch scripts to improve integration between IMatch Image Management and Smugmug
• SmugMug4Writer - Windows Live Writer plugin. Allows you to easily insert images into your blog posts.
• Gallery Album To SmugMug -Convert Gallery vs 1.x or 2.x albums to SmugMug complete with category/subcategory creation and captions.
• Migratr - migrate your photos from popular sharing services
• Komodo Drop - drag and drop application for Windows, Mac OSX and Linux
• FriendSync - Allows you to download your friends entire gallery
• ImageWell - Small but Powerful image editing application
• SmugMug Connection - WordPress? plugin connecting your admin panel directly to SmugMug?
• File Uploader SmugMug - upload photos from the command line.
• smug_screenshot - upload Mac OSX screenshots straight to your SmugMug? account.
• SmugMug on Facebook - feature SmugMug photos on Facebook account.
• Upload from Linux Command Line - from Joakim Recht
• ACDsee 10 Photo Manager - upload directly to SmugMug? from ACDsee 10
• bulkRegen - a mac application to bulk regenerate images for SmugMungous? sizes.
• MediaWiki tool - Extension allows embedding images from SmugMug? into a MediaWiki? wiki
  
• And over 250 more!

Are we missing yours? Add it!