flickrex v0.3.0 Flickr.Stats

Summary

Functions

Get a list of referring domains for a collection

Get a list of referrers from a given domain to a collection

Get the number of views on a collection for a given date

Returns a list of URLs for text files containing all your stats data (from November 26th 2007 onwards) for the currently auth’d user

Get a list of referring domains for a photo

Get a list of referrers from a given domain to a photo

Get the number of views, comments and favorites on a photo for a given date

Get a list of referring domains for a photoset

Get a list of referrers from a given domain to a photoset

Get the number of views on a photoset for a given date

Get a list of referring domains for a photostream

Get a list of referrers from a given domain to a user’s photostream

Get the number of views on a user’s photostream for a given date

List the photos with the most views, comments or favorites

Get the overall view counts for an account

Types

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

Functions

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

Get a list of referring domains for a collection

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • collection_id - The id of the collection to get stats for. If not provided, stats for all collections will be returned.

  • per_page - Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get a list of referrers from a given domain to a collection

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • domain - (required) The domain to return referrers for. This should be a hostname (eg: “flickr.com”) with no protocol or pathname.

  • collection_id - The id of the collection to get stats for. If not provided, stats for all collections will be returned.

  • per_page - Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get the number of views on a collection for a given date.

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • collection_id - (required) The id of the collection to get stats for.

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

Returns a list of URLs for text files containing all your stats data (from November 26th 2007 onwards) for the currently auth’d user.

Please note, these files will only be available until June 1, 2010 Noon PDT. For more information please check out this FAQ, or just go download your files.

This method requires authentication with “read” permission.

Arguments

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

Get a list of referring domains for a photo

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • photo_id - The id of the photo to get stats for. If not provided, stats for all photos will be returned.

  • per_page - Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get a list of referrers from a given domain to a photo

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • domain - (required) The domain to return referrers for. This should be a hostname (eg: “flickr.com”) with no protocol or pathname.

  • photo_id - The id of the photo to get stats for. If not provided, stats for all photos will be returned.

  • per_page - Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get the number of views, comments and favorites on a photo for a given date.

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • photo_id - (required) The id of the photo to get stats for.

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

Get a list of referring domains for a photoset

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • photoset_id - The id of the photoset to get stats for. If not provided, stats for all sets will be returned.

  • per_page - Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get a list of referrers from a given domain to a photoset

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • domain - (required) The domain to return referrers for. This should be a hostname (eg: “flickr.com”) with no protocol or pathname.

  • photoset_id - The id of the photoset to get stats for. If not provided, stats for all sets will be returned.

  • per_page - Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get the number of views on a photoset for a given date.

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • photoset_id - (required) The id of the photoset to get stats for.

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

Get a list of referring domains for a photostream

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • per_page - Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get a list of referrers from a given domain to a user’s photostream

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.

  • domain - (required) The domain to return referrers for. This should be a hostname (eg: “flickr.com”) with no protocol or pathname.

  • per_page - Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100.

  • page - The page of results to return. If this argument is omitted, it defaults to 1.

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

Get the number of views on a user’s photostream for a given date.

This method requires authentication with “read” permission.

Arguments

  • date - (required) Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.
get_total_views(client, args \\ [])
get_total_views(client, args) :: response

Get the overall view counts for an account

This method requires authentication with “read” permission.

Arguments

  • date - Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. A day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day. If no date is provided, all time view counts will be returned.