Web Service Methods

API → Tags

get_popular_tags

Retuns a list of the 100 most popular tags.

Arguments:
  • api_key (required)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Popular tags on 43 Things</title>
  <link href="http://www.43things.com/tags" rel="alternate" type="text/html"/>
  <tags>
    <tag count="546">travel</tag>
    <tag count="360">music</tag>
    <tag count="302">life</tag>
    <tag count="291">health</tag>
    <tag count="223">writing</tag>
    <tag count="212">learn</tag>
    <tag count="205">programming</tag>
    <tag count="204">art</tag>
    <tag count="198">exercise</tag>
    <tag count="190">love</tag>
  </tags>
</feed>

Demo: /service/get_popular_tags

search_tags

Retuns a list of tags that match the term given in the q* argument, sorted by the tag’s popularity.

*Arguments:
  • api_key (required)
  • q (required)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Tag search results for "travel" on 43 Things</title>
  <link href="http://www.43things.com/search/query?q=travel" rel="alternate" type="text/html"/>
  <query>travel</query>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>35</total>
    <next_offset>20</next_offset>
  </pagination>
  <tags>
    <tag count="394">travel</tag>
    <tag count="1">travelling</tag>
    <tag count="1">travel.</tag>
    <tag count="1">world travel</tag>
    <tag count="1">travel to china</tag>
    <tag count="1">travel to spain</tag>
    <tag count="3">travel to italy</tag>
    <tag count="2">space travel</tag>
    <tag count="1">travel texas</tag>
    <tag count="1">international travel</tag>
    <tag count="1">ireland travel</tag>
    <tag count="1">travel tibet</tag>
    <tag count="2">travel writing</tag>
    <tag count="1">wine travel</tag>
    <tag count="1">thailand travel</tag>
    <tag count="1">mexico travel</tag>
    <tag count="1">brazil travel</tag>
    <tag count="1">travel china</tag>
    <tag count="1">travel sagada</tag>
    <tag count="1">travel canada</tag>
  </tags>
</feed>

Demo: /service/search_tags?q=travel

get_tags_goals

Returns a list of goals that have been tagged with the given tag, sorted by the number of times the goal has been tagged with this tag (not by the popularity of the goal).

Arguments:
  • api_key (required)
  • id (required)
  • offset (optional, default is 0)
  • max (optional, default is 20 and can’t be higher than 20)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Goals that match the tag "travel" on 43 Things</title>
  <link href="http://www.43things.com/tag/travel" rel="alternate" type="text/html"/>
  <pagination>
    <offset>0</offset>
    <max>20</max>
    <total>388</total>
    <next_offset>20</next_offset>
  </pagination>
  <GOAL OBJECT>
  <GOAL OBJECT>
  <GOAL OBJECT>

The response contains this common object: Goal

Demo: /service/get_tags_goals?id=travel

get_tags_similarities

Returns a list of up to 5 similar tags.

Arguments:
  • api_key (required)
  • id (required)
An Example Response: 
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://43things.com/xml/2005/rc#">
  <title>Tags similar to "travel" on 43 Things</title>
  <link href="http://www.43things.com/tag/travel" rel="alternate" type="text/html"/>
  <tags>
    <tag count="52">europe</tag>
    <tag count="49">vacation</tag>
    <tag count="49">visit</tag>
    <tag count="29">tourism</tag>
    <tag count="25">italy</tag>
  </tags>
</feed>

Demo: /service/get_tags_similarities?id=travel