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”?>
Popular tags on 43 Places
travel
restaurant
food
history beach art music architecture culture bar mountains hiking nature europe museum
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”?>
Tag search results for “bar” on 43 Places
bar
0
20
18
bar bars wine bar piano bar biker bar dive bar temple bar beach bar strip bars recovery bar restaurant/bar hoxton bar bar harbor bar restaurant byob stripper bar bar harbor brewing company no-more-martini-bar the bar harbor inn w/balcony
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”?>
Places that match the tag “romantic” on 43 Places
0
20
10
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”?>
Tags similar to “restaurant” on 43 Places
food
bar
lunch
dinner
vegetarian
