The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.places.tagsForPlace
Return a list of the top 100 unique tags for a Flickr Places or Where on Earth (WOE) ID
Authentication
This method does not require authentication.
Arguments
api_key(Required)- Your API application key. See here for more details.
woe_id(Optional)- A Where on Earth identifier to use to filter photo clusters.
(While optional, you must pass either a valid Places ID or a WOE ID.) place_id(Optional)- A Flickr Places identifier to use to filter photo clusters.
(While optional, you must pass either a valid Places ID or a WOE ID.) min_upload_date(Optional)- Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp.
max_upload_date(Optional)- Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp.
min_taken_date(Optional)- Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime.
max_taken_date(Optional)- Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime.
Example Response
<tags total="100"> <tag count="31775">montreal</tag> <tag count="20585">canada</tag> <tag count="12319">montréal</tag> <tag count="12154">quebec</tag> <tag count="6471">québec</tag> <tag count="2173">sylvainmichaud</tag> <tag count="2091">nikon</tag> <tag count="1541">lucbus</tag> <tag count="1539">music</tag> <tag count="1479">urban</tag> <tag count="1425">lucbussieres</tag> <tag count="1419">festival</tag> </tags>
Error Codes
1: Required parameter missing- One or more parameters was not included with the API request
2: Not a valid Places ID- An invalid Places (or WOE) identifier was included with your request.
3: Place not found- An invalid Places (or WOE) identifier was included with your request.
100: Invalid API Key- The API key passed was not valid or has expired.
105: Service currently unavailable- The requested service is temporarily unavailable.
106: Write operation failed- The requested operation failed due to a temporary issue.
111: Format "xxx" not found- The requested response format was not found.
112: Method "xxx" not found- The requested method was not found.
114: Invalid SOAP envelope- The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call- The XML-RPC request document could not be parsed.
116: Bad URL found- One or more arguments contained a URL that has been used for abuse on Flickr.