tags.getList

Description

Returns a list of tags for items on the site

Required parameters

  • None

API Version

Version 1&2

Optional parameters

  • label :
    the text of the tag
  • frequency :
    the frequency at which the tag has been used across the system
  • user_id :
    the id number of the user who applied the tag to a piece of content
  • type :
    the type of content to which the tag has been applied. There are four possible values:

    • blog
    • videos
    • audio
    • photos
  • item_id :
    the id number of the piece of content to which the tag has been applied. This requires the type parameter to also be set. The id would come from one of the following calls based on the content type:

Example response

<?xml version="1.0"?>
<response status="ok" time="Tue, 22 Apr 2008 16:40:21 -0500">
    <tags count="2" total="21">
        <tag>
            <label>56565</label>
            <frequency>1</frequency>

            <link>http://demo.vm.smallworldlabs.com/index.php?page_id=310&amp;tag=56565</link>
        </tag>
        <tag>
            <label>
                <![CDATA[beans]]>

            </label>
            <frequency>1</frequency>
            <link>http://demo.vm.smallworldlabs.com/index.php?page_id=310&amp;tag=beans</link>
        </tag>

    </tags>
</response>