flickcurl_free_tag ()

void
flickcurl_free_tag (flickcurl_tag *t);

Destructor for tag object

flickcurl_free_tags ()

void
flickcurl_free_tags (flickcurl_tag **tags);

Destructor for array of tag objects

flickcurl_free_tag_clusters ()

void
flickcurl_free_tag_clusters (flickcurl_tag_clusters *tcs);

Destructor for tag clusters object

flickcurl_tag_handler ()

void
(*flickcurl_tag_handler) (void *user_data,
                          flickcurl_tag *tag);

Flickcurl Tag handler callback.

flickcurl_tags_getClusterPhotos ()

flickcurl_photos_list *
flickcurl_tags_getClusterPhotos (flickcurl *fc,
                                 const char *tag,
                                 const char *cluster_id,
                                 flickcurl_photos_list_params *list_params);

Returns the first 24 photos for a given tag cluster

Implements flickr.tags.getClusterPhotos (1.7)

Added to API (not announced) some time between 2008-09-04 and 2008-09-19

flickcurl_tags_getClusters ()

flickcurl_tag_clusters *
flickcurl_tags_getClusters (flickcurl *fc,
                            const char *tag);

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

Implements flickr.tags.getClusters (1.5)

"There is no pagination for this method as the number of clusters for a single tag is capped at 5 and each cluster may contain between 1 - 50 tags (give or take)."

As announced 2008-07-17 http://tech.groups.yahoo.com/group/yws-flickr/message/4218

flickcurl_tags_getHotList ()

flickcurl_tag **
flickcurl_tags_getHotList (flickcurl *fc,
                           const char *period,
                           int tag_count);

Returns a list of hot tags for the given period.

Implements flickr.tags.getHotList (0.9)

flickcurl_tags_getListPhoto ()

flickcurl_tag **
flickcurl_tags_getListPhoto (flickcurl *fc,
                             const char *photo_id);

Get the tag list for a given photo.

Implements flickr.tags.getListPhoto (0.9)

flickcurl_tags_getListUser ()

flickcurl_tag **
flickcurl_tags_getListUser (flickcurl *fc,
                            const char *user_id);

Get the tag list for a given user (or current user)

Implements flickr.tags.getListUser (0.9)

FIXME: API docs says user_id is optional but it is not.

flickcurl_tags_getListUserPopular ()

flickcurl_tag **
flickcurl_tags_getListUserPopular (flickcurl *fc,
                                   const char *user_id,
                                   int pop_count);

Get the popular tag list for a given user (or current user)

Implements flickr.tags.getListUserPopular (0.9)

flickcurl_tags_getListUserRaw ()

flickcurl_tag **
flickcurl_tags_getListUserRaw (flickcurl *fc,
                               const char *tag);

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

Implements flickr.tags.getListUserRaw (0.9)

flickcurl_tags_getMostFrequentlyUsed ()

flickcurl_tag **
flickcurl_tags_getMostFrequentlyUsed (flickcurl *fc);

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

Implements flickr.tags.getMostFrequentlyUsed (1.25)

flickcurl_tags_getRelated ()

flickcurl_tag **
flickcurl_tags_getRelated (flickcurl *fc,
                           const char *tag);

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

Implements flickr.tags.getRelated (0.9)

flickcurl_tag

typedef struct {
  struct flickcurl_photo_s* photo;
  char* id;
  char* author;
  char* authorname;
  char* raw;
  char* cooked;
  int machine_tag;
  int count;
} flickcurl_tag;

A tag OR a posting of a tag about a photo by a user OR a tag in a histogram

Most of these fields may be NULL, 0 for numbers but not all. Either raw or cooked MUST appear.

A Photo Tag.

flickcurl_tag_cluster

typedef struct {
  int count;
  char** tags;
} flickcurl_tag_cluster;

A cluster (set) of tag names

flickcurl_tag_clusters

typedef struct {
  int count;
  flickcurl_tag_cluster** clusters;
} flickcurl_tag_clusters;

A set of clusters of tag names