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";