The App GardenCreate an App API Documentation Feeds What is the App Garden? |
flickr.galleries.getPhotos
Return the list of photos for a gallery
Authentication
This method does not require authentication.
Arguments
api_key
(Required)- Your API application key. See here for more details.
gallery_id
(Required)- The ID of the gallery of photos to return
continuation
(Optional)- Using this parameter indicates to the server that the client is using the new, continuation based pagination rather than the older page/per_page based pagination. 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 the "per_page" field 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".
get_user_info
(Optional)- set to 1 if user details should be returned
get_gallery_info
(Optional)- if set to 1, info about the gallery is also returned
extras
(Optional)- A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are:
description
,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_q
,url_m
,url_n
,url_z
,url_c
,url_l
,url_o
per_page
(Optional)- Number of photos 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.
Example Response
<photos page="1" pages="1" perpage="500" total="2"> <photo id="2822546461" owner="78398753@N00" secret="2dbcdb589f" server="1" farm="1" title="FOO" ispublic="1" isfriend="0" isfamily="0" is_primary="1" has_comment="1"> <comment>best cat picture ever!</comment> </photo> <photo id="2822544806" owner="78398753@N00" secret="bd93cbe917" server="1" farm="1" title="OOK" ispublic="1" isfriend="0" isfamily="0" is_primary="0" has_comment="0" /> </photos>Returns a standard photo response. Additionally if the gallery creator has included a comment with the photo this will be then the photo element will have the attribute has_comment="1" and the child element "comment" will be present.
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.