Ma.gnolia Blog: The Mirrord API
A common request we get from our community is for integration with more tools and services.
The ecosystem which has grown around del.icio.us and other social bookmarking services is a significant part of their appeal. These tools and toys, like Damien’s heavily dugg Dashboard widget – Digg: Ma.gnolia Blossom (View Details) – not only help spread the good word, but also provide an easy way for users who are more comfortable with their desktop environment or browser toolbar to explore social bookmarking.
In May, we launched our own API, which has been well received, mainly because the access it provides is both wide – you aren’t limited to your own bookmarks – and deep – you get thumbnail urls and detailed bookmark entry data. That said, the easier and more widely accessible we make developing for Ma.gnolia, the more people will play with it, and the richer Ma.gnolia’s garden becomes. (Please excuse about the obvious botanical metaphor.)
So, today, we’ve put in place a new API which mirrors the commands of the del.icio.us API (View Details), and therefore several other social bookmarking services. The skinny is as follows:
1. Replace your calls to “https://api.del.icio.us/v1” with “https://ma.gnolia.com/api/mirrord/v1”.
2. We don’t support any of the bundle commands, as we don’t have tag bundles.
3. Spaces in tags are converted into underscores when displayed through the Mirrord API.
We hope that our Mirrord API helps brings some of the great social bookmarking tools that are already out there to Ma.gnolia and provides an easy in for new developers.
As always, feel free to ask for help if you have any questions or problems with our APIs. And, once you’ve built something, be sure to let everyone know by bookmarking it, talking it up in Ma.gnolia Users or Ma.gnolia Developers, or even just dropping a comment here.
Posted by Larry on August 23, 2006 | Mark This Post
Member Comments
Justin on August 23, 2006
I'm not seeing tags come through in posts. I can pull them down if they're added via the website, but can't add posts with tags via the API.
Larry on August 23, 2006
Thanks for the catch, Justin. We were looking at the wrong parameter, "tag" instead of "tags". It's all fixed, and please let us know if you find any more issues.
Todd on August 24, 2006
We're hoping that this will speed up adoption in Flock, elvyse. Chris Messina commented that a lot of the Flock bookmarks management is built around what Del.icio.us does, so this should make it much easier for them to get the basics working with Ma.gnolia. After that, they can start looking into the more advanced and richer stuff offered by our main API, which would bring in groups, contacts, that sort of stuff. There's lots of potential and the Mirrord API gets that rolling.
Pete on September 1, 2006
I've got my delisync script working now, but I need to clean up the code a bit before releasing. (It allows the syncing of bookmarks between sites that use the same API, Ma.gnolia, del.icio.us, scuttle, etc...)
Andy on September 2, 2006
Have to admit.. Integration with flock is a major thing i'd like to see on ma.gnolia. But then again I just got here literaly ;)
Just moved over from delicious, things seem impressive, I like the interface, much more pleasing to the eye and brain I find. And now, back to the testing ;)
Brydon on September 4, 2006
Apologies if I'm missing this but is there instructions anywhere on how to get the API working with Flock? I've tried editing DELICIOUS_HOST etc in Flock's components/flockFavoritesWebServiceDelicious.js but that doesn't appear to work.
Todd on September 5, 2006
We haven't seen any instances of Ma.gnolia working in Flock yet, Brydon. The Flock forums might have some clues, if not helpful people there who could point you in the right direction.
mobilicious on September 6, 2006
Thanks again for releasing this mirrored API. Because of it, Mobilicio.us now has support for Ma.gnolia.
We blogged about it here:
http://mobilicio.us/www/blog/2006/09/06/magnolia-integration-is-live/
mobilicious on September 6, 2006
Also, if anyone is using the MySQLicious library and trying to get it to work with the Ma.gnolia mirror API:
Check the API calls in the MySQLicious code for double slashes. When I get a second, I'm going to get a hold of the MySQLicious folks and let them know and will post something in more detail at my Stranger Studios site. In the meantime, feel free to email me.
Todd on September 7, 2006
Thanks for adding Ma.gnolia support to Mobilicio.us, Jason! Along with the QuickSilver plugin that's still being ironed out, you're among the first to embrace Mirrord and to get the ball rolling.
Follow these comments via 
John on August 23, 2006
Great idea. Besides the great customer support, this is one of the main reasons I use magnolia--new and useful features. Keep up the great work!