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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Popular tags on 43 Places</title>
  <link href="http://www.43places.com/tags" rel="alternate" type="text/html"/>
  <tags>
<tag count="449">travel</tag>
<tag count="290">restaurant</tag>
<tag count="269">food</tag>
<tag count="255">history</tag>

<tag count="252">beach</tag>
<tag count="194">art</tag>
<tag count="172">music</tag>
<tag count="166">architecture</tag>
<tag count="149">culture</tag>
<tag count="141">bar</tag>
<tag count="135">mountains</tag>
<tag count="133">hiking</tag>
<tag count="126">nature</tag>

<tag count="121">europe</tag>
<tag count="119"></tag>
<tag count="115">museum</tag>
</feed>

Demo: /service/get_popular_tags

search_tags

Returns 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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Tag search results for "bar" on 43 Places</title>
  <link href="http://www.43places.com/search/query?q=bar" rel="alternate" type="text/html"/>
  <query>bar</query>
<pagination>
  <offset>0</offset>
  <max>20</max>
  <total>18</total>
  <next_offset></next_offset>
</pagination>
  <tags>
<tag count="141">bar</tag>
<tag count="41">bars</tag>
<tag count="5">wine bar</tag>
<tag count="1">piano bar</tag>
<tag count="1">biker bar</tag>
<tag count="5">dive bar</tag>
<tag count="1">temple bar</tag>
<tag count="1">beach bar</tag>
<tag count="1">strip bars</tag>
<tag count="1">recovery bar</tag>
<tag count="1">restaurant/bar</tag>
<tag count="1">hoxton bar</tag>
<tag count="2">bar harbor</tag>
<tag count="1">bar restaurant</tag>
<tag count="1">byob stripper bar</tag>
<tag count="1">bar harbor brewing company</tag>
<tag count="1">no-more-martini-bar</tag>
<tag count="1">the bar harbor inn w/balcony</tag>
  </tags>
</feed>

Demo: /service/search_tags?q=bar

get_tags_places

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

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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Places that match the tag "romantic" on 43 Places</title>
  <link href="http://www.43places.com/tag/romantic" rel="alternate" type="text/html"/>
<pagination>
  <offset>0</offset>
  <max>20</max>
  <total>10</total>
  <next_offset></next_offset>
</pagination>
<PLACE OBJECT>
<PLACE OBJECT>
<PLACE OBJECT>
</feed>

The response contains this common object: Place

Demo: /service/get_tags_places?id=romantic

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:dc="http://purl.org/dc/elements/1.1/" xmlns="http://43places.com/xml/2005/rc#">
  <title>Tags similar to "restaurant" on 43 Places</title>
  <link href="http://www.43places.com/tag/restaurant" rel="alternate" type="text/html"/>
  <tags>
<tag count="269">food</tag>
<tag count="141">bar</tag>
<tag count="27">lunch</tag>
<tag count="23">dinner</tag>
<tag count="20">vegetarian</tag>
  </tags>
</feed>

Demo: /service/get_tags_similarities?id=restaurant