class FlickRaw::Flickr::Tags

Public Instance Methods

getClusterPhotos(:tag => 'tag',:cluster_id => 'cluster_id') click to toggle source

flickr.tags.getClusterPhotos request.

Returns the first 24 photos for a given tag cluster

Arguments

tag (required)

The tag that this cluster belongs to.

cluster_id (required)

The top three tags for the cluster, separated by dashes (just like the url).

Error codes

  • 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.

# Generated automatically from flickr api
  def getClusterPhotos(*args)
    @flickr.call 'flickr.tags.getClusterPhotos', *args
  end
getClusters(:tag => 'tag') click to toggle source

flickr.tags.getClusters request.

Gives you a list of tag clusters for the given tag.

Arguments

tag (required)

The tag to fetch clusters for.

Error codes

  • 1: Tag cluster not found

    The tag was invalid or no cluster exists for that tag.

  • 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.

Returns

farmanimalscattlegreenlandscapecountryside
# Generated automatically from flickr api
  def getClusters(*args)
    @flickr.call 'flickr.tags.getClusters', *args
  end
getHotList(:period => 'period',:count => 'count') click to toggle source

flickr.tags.getHotList request.

Returns a list of hot tags for the given period.

Arguments

period

The period for which to fetch hot tags. Valid values are day and week (defaults to day).

count

The number of tags to return. Defaults to 20. Maximum allowed value is 200.

Error codes

  • 1: Invalid period

    The specified period was not understood.

  • 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.

Returns

northerncaliforniatop20keychainzbselfportraittuesdayjan06
# Generated automatically from flickr api
  def getHotList(*args)
    @flickr.call 'flickr.tags.getHotList', *args
  end
getListPhoto(:photo_id => 'photo_id') click to toggle source

flickr.tags.getListPhoto request.

Get the tag list for a given photo.

Arguments

photo_id (required)

The id of the photo to return tags for.

Error codes

  • 1: Photo not found

    The photo id passed was not a valid photo id.

  • 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.

Returns

tag1tag2
# Generated automatically from flickr api
  def getListPhoto(*args)
    @flickr.call 'flickr.tags.getListPhoto', *args
  end
getListUser(:user_id => 'user_id') click to toggle source

flickr.tags.getListUser request.

Get the tag list for a given user (or the currently logged in user).

Arguments

user_id

The NSID of the user to fetch the tag list for. If this argument is not specified, the currently logged in user (if any) is assumed.

Error codes

  • 1: User not found

    The user NSID passed was not a valid user NSID and the calling user was not logged in.

  • 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.

Returns

gulltag1tag2tagstest
# Generated automatically from flickr api
  def getListUser(*args)
    @flickr.call 'flickr.tags.getListUser', *args
  end
getListUserPopular(:user_id => 'user_id',:count => 'count') click to toggle source

flickr.tags.getListUserPopular request.

Get the popular tags for a given user (or the currently logged in user).

Arguments

user_id

The NSID of the user to fetch the tag list for. If this argument is not specified, the currently logged in user (if any) is assumed.

count

Number of popular tags to return. defaults to 10 when this argument is not present.

Error codes

  • 1: User not found

    The user NSID passed was not a valid user NSID and the calling user was not logged in.

  • 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.

Returns

barfoogulltagstest
# Generated automatically from flickr api
  def getListUserPopular(*args)
    @flickr.call 'flickr.tags.getListUserPopular', *args
  end
getListUserRaw(:tag => 'tag') click to toggle source

flickr.tags.getListUserRaw request.

Get the raw versions of a given tag (or all tags) for the currently logged-in user.

Arguments

tag

The tag you want to retrieve all raw versions for.

Error codes

  • 1: User not found

    The calling user was not logged in.

  • 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.

Returns

fooFoof:oo
# Generated automatically from flickr api
  def getListUserRaw(*args)
    @flickr.call 'flickr.tags.getListUserRaw', *args
  end
getMostFrequentlyUsed() click to toggle source

flickr.tags.getMostFrequentlyUsed request.

Returns a list of most frequently used tags for a user.

Arguments

Error codes

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 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.

Returns

blahpublicdomain
# Generated automatically from flickr api
  def getMostFrequentlyUsed(*args)
    @flickr.call 'flickr.tags.getMostFrequentlyUsed', *args
  end
getRelated(:tag => 'tag') click to toggle source

flickr.tags.getRelated request.

Returns a list of tags 'related' to the given tag, based on clustered usage analysis.

Arguments

tag (required)

The tag to fetch related tags for.

Error codes

  • 1: Tag not found

    The tag argument was missing.

  • 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.

Returns

englandthamestubebigbenuk
# Generated automatically from flickr api
  def getRelated(*args)
    @flickr.call 'flickr.tags.getRelated', *args
  end