Extra result fields

Search results can be made to return additional fields in the photo results by using the extras configuration of the search API. (This applies to both results returning the flickcurl_photo struct as well as syntax formats described in the next section.) This is done by configuring the field extras in the flickcurl_photos_list_params structure containing a , (comma) separated list of the extra names like name1,name2.

The known search 'extras' names and what they fields they return are as follows (at the time this documentation was built):

date_taken	Date item was taken
date_upload	Date item was uploaded
geo	Geotagging latitude, longitude and accuracy
icon_server	Item owner icon fields
last_update	Date item was last updated
license	Item License
machine_tags	Machine tags
media	Item Format: photo or video
o_dims	Original item dimensions
original_format	Original item secret and format
owner_name	Item owner ID
path_alias	Path alias for owner like /photos/USERNAME
tags	Item clean tags (safe for HTML, URLs)
url_c	URL of medium 800, 800 on longest size image
url_m	URL of small, medium size image
url_n	URL of small, 320 on longest side size image
url_o	URL of original size image
url_q	URL of large square 150x150 size image
url_s	URL of small suqare 75x75 size image
url_sq	URL of square size image
url_t	URL of thumbnail, 100 on longest side size image
views	Number of times item has been viewed

Use flickcurl_get_extras_format_info() to get the known extra names and descriptions at runtime.

The following code fragment sets the extras field to the single extra name original_format which adds to the the search results flickcurl_photo objects fields for the original item secret and original item format (like "jpg").

  flickcurl_photos_list_params list_params;

  flickcurl_photos_list_params_init(&list_params);

  list_params.extras = "original_format";