Taggly

API

Taggly supports most of the Del.icio.us API . Almost all of the neat tools made for that system can be modified to work with Taggly instead. If you find a tool that won't let you change the API address, ask the creator to add this setting. You never know, they might just do it.

What is API?

Application Programming Interface. A set of interface definitions (functions, subroutines, data structures or class descriptions) which together provide a convenient interface to the functions of a subsystem and which insulate the application from the minutiae of the implementation.

How does Taggly APIs work?

All our APIs uses https and HTTP-Auth. As we often develop new versions of the APIs, you can find many ones. Please be patient till they will be stable.

Important Notes:

To avoid getting automatically throttled, please, wait AT LEAST ONE SECOND between queries, particularly if you are releasing a library to access the API.
If you watch for an 503 error, it may mean that you have been throttled.
To let us completely test our APIs, please let us know (feedback@taggly.com) if you are going to release software that uses this publicly.
If you’ll use some Agent-names such as "Java/1.4.3" or "lwp-perl" etc, you’ll be likely to be banned, so please use some identifiable name.
If you are releasing code to be used for others, your application MUST NOT add any links without a user's explicit direction. At the same, you MUST NOT modify any urls without the user's explicit direction.

Methods

Tags – Here’s a list of tags, which can be renamed.
Posts – Here’s a list of posts, which can be added and removed.

http://www.taggly.com/api/tags/get

This will return a list of our tags and the number of times it has been used by a user.

Example of response at your call:

http://www.taggly.com/api/tags/rename?

This will rename an existing tag with a new tag name, chosen by you.

Arguments

&old (not optional) – You HAVE TO specify the current name of the tag to be renamed. &new (not optional) – You HAVE TO specify the new name of the tag to be renamed.

Example of response at your call:

Go to Top

Posts

http://www.taggly.com/api/posts/get?

This function will return all the posts that match the argument you have chosen. If there’s no match given, latest date will be used.

Arguments

&tag (optional). This tag is used to filter. &dt (optional). The filter is made also by the date in the format CCYY-MM-DDThh:mm:ssZ. &url (optional). Tags will be matched also by the use of this parameter.

Example of response at your call:

http://www.taggly.com/api/posts/recent?

This function will return a list of the most recent posts, matched by the filter of the argument, chosen by you. The maximum numbers of the post that will be shown is 100.

Arguments

&tag (optional). This tag is used to filter. &count (optional). This is the number of tags to return. As default it is 15, the maximum is, as written down before, 100.

Example of response at your call:

http://www.taggly.com/api/posts/all?

This function will return all posts. Caution is advised when you use this.

Arguments

&tag (optional). This tag is used to filter.

Example of response at your call:

http://www.taggly.com/api/posts/dates?

This function will return some dates with the number of posts made on each date.

Arguments

&tag (optional). This tag is used to filter.

Example of response at your call:

http://www.taggly.com/api/posts/add?

This function will add a post to www.taggly.com

Arguments

&url (not optional) – You HAVE TO specify the url for the post.
&description (not optional) - You HAVE TO specify the description for the post.
&extended (optional) – It is needed to specify the notes for the post.
&tags (optional) – It is needed to specify the tags for the post (delimited by a space).
&dt (optional) – It is needed to specify the date for the post in the format "CCYY-MM-DDThh:mm:ssZ". Besides, it requires a "T" and "Z", as specified in ISO8601 at http://www.cl.cam.ac.uk/~mgk25/iso-time.html. For example: "1984-09-01T14:21:31Z"
&replace=no (optional) – Please note not to replace post, if a specified url has already been posted.
&shared=no (optional) – This parameter specify if the the post is private and if can be viewed by anyone.

Example of response at your call:

If the post has successfully been inserted:

If the insert of the post has failed:

http://www.taggly.com/api/posts/delete?

This function will delete a post from www.taggly.com

Arguments

&url (not optional) – You HAVE TO specify the url of the post.

Example of response at your call:

Go to Top