XML-RPC Protocol Method: getusertags

Retrieves a list of the user's defined tags.

Inputs
usejournal Scalar. Optional. Journal username that authenticating user has 'usejournal' access in, as given in the 'login' mode. Specify this key to get tags for another account that you have access to.

Outputs
tags Array of structs. Required. A list of structs for all of the returned tags. Containing keys:


 * name Scalar. Required. The name of the tag being returned.
 * security_level Scalar. Required. The security (visibility) of the tag being returned. This can be one of 'public', 'private', 'friends', or 'group'. Note that 'group' doesn't provide any information about which groups, but that can be inferred from the security breakdown elsewhere in the structure.
 * uses Scalar. Optional. If the tag has been used, returns the number of times it's been used overall.
 * display Scalar. Optional. If present and on, indicates that this tag is visible to the S2 style system. Tags with this value set to off are still usable, they're just not exposed to S2.
 * security Struct. Optional. Shows the breakdown of use by security category. Containing keys:
 * public Scalar. Optional. The number of times this tag has been used on a public post.
 * private Scalar. Optional. The number of times this tag has been used on a private post.
 * friends Scalar. Optional. The number of times this tag has been used on a Friends-only post.
 * groups Struct. Optional. Entries in the groups structure have the key being the id of the group (id as shown in gettrustgroups mode) and the value being the number of times this tag has appeared on an entry secured to that group.