Methods

The HTTP methods GET, POST, PUT and DELETE can be applied to these URIs. Here a table that describes what each of the methods do when applied to a URI.

Method	Description
.../folder/{folder_id}
GET	Returns the XML that represent the folder
POST	Creates a bookmark or folder in the folder based on the XML that is in the request
PUT	Updates the folder based on the XML that is in the request
DELETE	Delete the folder
.../folderitems/{folder_id}
GET	Returns the XML that represent list of subfolder and bookmarks in the folder
.../bookmark/{bookmark_id}
GET	Returns the XML that represent the bookmark
PUT	Updates the bookmark based on the XML that is in the request
DELETE	Deletes the bookmark
.../favorites
GET	Returns the XML that represent list the favorite bookmarks of the user
.../added
GET	Returns the XML that represent the last 20 bookmarks that have been added.
.../popular
GET	Returns the XML that represent the 20 most visited bookmarks.
.../recent
GET	Returns the XML that represent the 20 most recent visited bookmarks.
.../reminders
GET	Returns the XML that represent the active reminder bookmarks.
.../search?search={search string}
GET	Returns the XML with folders and bookmarks that are found.

XML

<xbel>
  <folder public="yes">
    <title>My Business folder</title>
  </folder>
</xbel>

All the XML fragments have the outer <xbel> tag. public is an attribute. folder and title are tags.

Encoding

Security

To access the API you need to authenticate with your linkaGoGo account-name and password. When you access the API through your browser you will automatically get a login dialog. The API supports the HTTP Basic and Digest authentication methods. Digest is much safer then Basic, as it doesn't send your password over the Internet. See the HTTP Authentication specification RFC 2617 for more details.

You can also use SSL to access the API. Just use the https// prefix. Note all returning uri will have https:// protocol prefixes.

Compression

Examples

More useful applications are written with languages such as Java, C, C++, PHP, Javascript, Ajax etc.
If you are a plugin developer for the Firefox, Internet Explorer or Google SidePanels you can use the API to build / replace a linkaGoGo powered bookmark manager. Other ideas could be a Windows Explorer like application for browsing your bookmarks. Or you can integrate linkaGoGo bookmarking in your Custom solution. Note we provide lucrative discounts for subscription resellers. Contact us at [email protected]

Browser session example

First get the contents of the root folder:
http://www.linkagogo.com/api/rest/private/folderitems
Note the browser will prompt for the linkagogo username and password.

Get the contents of a subfolder. Copy the content attribute of one of the folders in your clipboard, then paste it in the browser address bar:
http://www.linkagogo.com/api/rest/private/folderitems/{folder_id}

Get the properties of the subfolder. Copy the uri value of one of the folders in your clipboard, then paste it in the browser address bar:
http://www.linkagogo.com/api/rest/private/folder/{folder_id}

Get the properties of a bookmark. Copy the uri value of one of the bookmarks in your clipboard, then paste it in the browser address bar:
http://www.linkagogo.com/api/rest/private/bookmark/{bookmark_id}

Visit the bookmark's website. Copy the redirect attribute of one of the bookmarks in your clipboard, then paste it in the browser address bar:
http://www.linkagogo.com/go/To?url={bookmark_id}
Note the website should appear.

Now get the properties of the bookmark again. Copy the uri value of the bookmarks in your clipboard, then paste it in the browser address bar:
http://www.linkagogo.com/api/rest/private/bookmark/{bookmark_id}
Note the visits and last_visited attributes are now updated.

Planned future features

• Customizable return attributes on the .../folderitems uri.
• Let us know if you have more requests. [email protected]

Usage

• Do not call the API more then once per second.
• Do not use the API to download your whole bookmark collection in a short period of time. Use the download or commandline feature for this.
• Do not make one or more calls on our API for every hit on your webpage (Use a cache)
• If you write a third-party application do not change the contents of a linkaGoGo member bookmark collection without his consent.
• If you are planning to release a third-party application, let us know of your plans in advance [email protected].
• When writing a third-party application make sure the user-agent tag is uniquely identifiable.
• During the beta we reserve rights to change the API.

Subscriptions

Showcases

LinkaGoGo Browser, an example of using the linkaGoGo Web API and stylesheets. See here the xslt source.

linkaGoGo Organizer

LinkaGoGo Organizer. A small application to quickly organize your folders and bookmarks. Drag or bookmark the link LinkaGoGo Organizer into your Links / Bookmarks toolbar for easy and quick access.

Third-Party showcases

lggrem2rss, is a python script for converting linkaGoGo reminders into an RSS feed. The script retrieves your reminders through the linkaGoGo Web API and then converts them into an RSS file, which can then be hosted on your webserver. It also describes how you can run the script on a regular basis using a cron job. A nice example on how to access the linkaGoGo WEB API from Python. Provided by Broobles

Your Application/Plugin here