The App Garden |
flickr.favorites.getList
Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned.
Authentication
This method does not require authentication.
Arguments
api_key(Required)- Your API application key.See here for more details.
user_id(Optional)- The NSID of the user to fetch the favorites list for. If this argument is omitted, the favorites list for the calling user is returned.
min_fave_date(Optional)- Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp.
max_fave_date(Optional)- Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp.
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
This method returns the standard photo list xml:
<photospage="2"pages="89"perpage="10"total="881"><photoid="2636"owner="47058503995@N01"secret="a123456"server="2"title="test_04"ispublic="1"isfriend="0"isfamily="0" /><photoid="2635"owner="47058503995@N01"secret="b123456"server="2"title="test_03"ispublic="0"isfriend="1"isfamily="1" /><photoid="2633"owner="47058503995@N01"secret="c123456"server="2"title="test_01"ispublic="1"isfriend="0"isfamily="0" /><photoid="2610"owner="12037949754@N01"secret="d123456"server="2"title="00_tall"ispublic="1"isfriend="0"isfamily="0" /></photos>
To map<photo> elements to urls, please read theurl documentation.
Error Codes
1: User not found- The specified user NSID was not a valid flickr user.
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.