flickrex v0.3.0 Flickr.Tags

Summary

Functions

Returns the first 24 photos for a given tag cluster

Gives you a list of tag clusters for the given tag

Returns a list of hot tags for the given period

Get the tag list for a given photo

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

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

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

Returns a list of most frequently used tags for a user

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

Types

args()
args() :: Keyword.t
client()
client() :: Flickrex.Client.t
response()
response() :: Flickrex.Parser.response

Functions

get_cluster_photos(client, args \\ [])
get_cluster_photos(client, args) :: response

Returns the first 24 photos for a given tag cluster

This method does not require authentication.

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

get_clusters(client, args \\ [])
get_clusters(client, args) :: response

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

This method does not require authentication.

Arguments

  • tag - (required) The tag to fetch clusters for.
get_hot_list(client, args \\ [])
get_hot_list(client, args) :: response

Returns a list of hot tags for the given period.

This method does not require authentication.

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.

get_list_photo(client, args \\ [])
get_list_photo(client, args) :: response

Get the tag list for a given photo.

This method does not require authentication.

Arguments

  • photo_id - (required) The id of the photo to return tags for.
get_list_user(client, args \\ [])
get_list_user(client, args) :: response

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

This method does not require authentication.

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.
get_list_user_popular(client, args \\ [])
get_list_user_popular(client, args) :: response

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

This method does not require authentication.

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.

get_list_user_raw(client, args \\ [])
get_list_user_raw(client, args) :: response

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

This method does not require authentication.

Arguments

  • tag - The tag you want to retrieve all raw versions for.
get_most_frequently_used(client, args \\ [])
get_most_frequently_used(client, args) :: response

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

This method requires authentication with “read” permission.

Arguments

get_related(client, args \\ [])
get_related(client, args) :: response

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

This method does not require authentication.

Arguments

  • tag - (required) The tag to fetch related tags for.