flickr.galleries.getList

Return the list of galleries created by a user. Sorted from newest to oldest.

Authentication

This method does not require authentication.

Arguments

api_key (Required)
Your API application key. See here for more details.
user_id (Required)
The NSID of the user to get a galleries list for. If none is specified, the calling user is assumed.
per_page (Optional)
Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page (Optional)
The page of results to return. If this argument is omitted, it defaults to 1.
primary_photo_extras (Optional)
A comma-delimited list of extra information to fetch for the primary photo. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_m, url_o
continuation (Required)
The first request must pass the "continuation" parameter with the value of "0". The server responds back with a response that includes the "continuation" field along with "pages" and "total" fields in the response. For the subsequent requests, the client must relay the value of the "continuation" response field as the value of the "continuation" request parameter. On the last page of results, the server will respond with a continuation value of "-1".
sort_groups (Optional)
A comma-separated list of groups used to sort the output sets. If has_photo is present, any of the calling user's galleries containing photos referred to in photo_ids will be returned before other galleries. If suggested is present, a number of suggested galleries will be returned before other sets. The order of the sort_groups will dictate the order that the groups are returned in. Only available if continuation is used. The resulting output will include a "sort_group" parameter indicating the sort_group that each set is part of, or null if not applicable
photo_ids (Optional)
A comma-separated list of photo ids. If specified along with has_photo in sort_groups, each returned gallery will include a list of these photo ids that are present in the gallery as "has_requested_photos"
cover_photos (Optional)
set to 1 if cover photos for galleries should be returned. If primary photo exists, 1 primary photo and 2 other photos will be returned (in order). If not, 6 photos in order will be returned
primary_photo_cover_size (Optional)
size of primary photo on the cover (if primary photo exists in gallery). will default to 'q' if not set
cover_photos_size (Optional)
size of cover photos (will default to 'q' if not set)
limit (Optional)
number of cover photos to fetch for galleries without a primary photo. Default is 6
short_limit (Required)
number of cover photos to fetch (excluding primary photo) for galleries with a primary photo. Default is 2.

Example Response

<galleries total="9" page="1" pages="1" per_page="100" user_id="34427469121@N01">
  <gallery id="5704-72157622637971865" url="http://www.flickr.com/photos/george/galleries/72157622637971865" owner="34427469121@N01" date_create="1257711422" date_update="1260360756" primary_photo_id="107391222" primary_photo_server="39" primary_photo_farm="1" primary_photo_secret="ffa" count_photos="16" count_videos="2">
    <title>I like me some black &amp; white</title>
    <description>black and whites</description>
  </gallery>
  <gallery id="5704-72157622566655097" url="http://www.flickr.com/photos/george/galleries/72157622566655097" owner="34427469121@N01" date_create="1256852229" date_update="1260462343" primary_photo_id="497374910" primary_photo_server="231" primary_photo_farm="1" primary_photo_secret="9ae0f" count_photos="18" count_videos="0">
    <title>People Sleeping in Libraries</title>
    <description />
  </gallery>
</galleries>

Error Codes

100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
106: Write operation failed
The requested operation failed due to a temporary issue.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.

API Explorer

API Explorer : flickr.galleries.getList