diff --git a/build-api.js b/build-api.js new file mode 100644 index 0000000..071d204 --- /dev/null +++ b/build-api.js @@ -0,0 +1,19 @@ +var fs = require("fs"), + consolidated = { + "flickr.reflection.getMethods.json": JSON.parse(fs.readFileSync(__dirname + "/data/flickr/flickr.reflection.getMethods.json")); +} + +var jsonFiles = fs.readdirSync("./data/flickr/methods"); +for(var i=0, len=jsonFiles.length; iDo not poll this method more than once an hour." + }, + "response": { + "_content": "\r\n\t\r\n\t\tA set of photos\r\n\t\t\r\n\t\t\tyay\r\n\t\t\r\n\t\r\n\r\n\t\r\n\t\tA photo\r\n\t\t\r\n\t\t\ttest\r\n\t\t\tnice\r\n\t\t\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.activity.userPhotos.json": { + "method": { + "name": "flickr.activity.userPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of recent activity on photos belonging to the calling user. Do not poll this method more than once an hour." + }, + "response": { + "_content": "\r\n\t\r\n\t\tA set of photos\r\n\t\t\r\n\t\t\tyay\r\n\t\t\r\n\t\r\n\r\n\t\r\n\t\tA photo\r\n\t\t\r\n\t\t\ttest\r\n\t\t\tnice\r\n\t\t\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "timeframe", + "optional": "1", + "_content": "The timeframe in which to return updates for. This can be specified in days ('2d') or hours ('4h'). The default behavoir is to return changes since the beginning of the previous user session." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.checkToken.json": { + "method": { + "name": "flickr.auth.checkToken", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the credentials attached to an authentication token. This call must be signed, and is deprecated in favour of OAuth." + }, + "response": { + "_content": "\r\n\t976598454353455\r\n\tread\r\n\t\r\n" + }, + "explanation": { + "_content": "

perms can have values of none, read, write or delete. For more information, see the Auth API spec.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "auth_token", + "optional": "0", + "_content": "The authentication token to check." + } + ] + }, + "errors": { + "error": [ + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.getFrob.json": { + "method": { + "name": "flickr.auth.getFrob", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a frob to be used during authentication. This method call must be signed, and is deprecated in favour of OAuth." + }, + "response": { + "_content": "746563215463214621" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.getFullToken.json": { + "method": { + "name": "flickr.auth.getFullToken", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the full authentication token for a mini-token. This method call must be signed, and is deprecated in favour of OAuth." + }, + "response": { + "_content": "\r\n\t976598454353455\r\n\twrite\r\n\t\r\n" + }, + "explanation": { + "_content": "

perms can have values of none, read, write or delete. For more information, see the Auth API spec.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "mini_token", + "optional": "0", + "_content": "The mini-token typed in by a user. It should be 9 digits long. It may optionally contain dashes." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Mini-token not found", + "_content": "The passed mini-token was not valid." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.getToken.json": { + "method": { + "name": "flickr.auth.getToken", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the auth token for the given frob, if one has been attached. This method call must be signed, and is deprecated in favour of OAuth." + }, + "response": { + "_content": "\r\n\t976598454353455\r\n\twrite\r\n\t\r\n" + }, + "explanation": { + "_content": "

perms can have values of none, read, write or delete. For more information, see the Auth API spec.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "frob", + "optional": "0", + "_content": "The frob to check." + } + ] + }, + "errors": { + "error": [ + { + "code": "108", + "message": "Invalid frob", + "_content": "The specified frob does not exist or has already been used." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.oauth.checkToken.json": { + "method": { + "name": "flickr.auth.oauth.checkToken", + "needslogin": 0, + "needssigning": 1, + "requiredperms": 0, + "description": { + "_content": "Returns the credentials attached to an OAuth authentication token." + }, + "response": { + "_content": "\r\n 72157627611980735-09e87c3024f733da\r\n write\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "oauth_token", + "optional": "0", + "_content": "The OAuth authentication token to check." + } + ] + }, + "errors": { + "error": [ + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.auth.oauth.getAccessToken.json": { + "method": { + "name": "flickr.auth.oauth.getAccessToken", + "needslogin": 0, + "needssigning": 1, + "requiredperms": 0, + "description": { + "_content": "Exchange an auth token from the old Authentication API, to an OAuth access token. Calling this method will delete the auth token used to make the request." + }, + "response": { + "_content": " \r\n\t \r\n " + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.blogs.getList.json": { + "method": { + "name": "flickr.blogs.getList", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of configured blogs for the calling user." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n" + }, + "explanation": { + "_content": "

The needspassword attribute indicates whether a call to flickr.blogs.postPhoto for this blog will require a password to be sent. When flickr has a password already stored, needspassword is 0

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "service", + "optional": "1", + "_content": "Optionally only return blogs for a given service id. You can get a list of from flickr.blogs.getServices()." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.blogs.getServices.json": { + "method": { + "name": "flickr.blogs.getServices", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of Flickr supported blogging services" + }, + "response": { + "_content": "\r\nBlogger\r\nTypepad\r\nMovable Type\r\nLiveJournal\r\nWordpress\r\nMetaWeblogAPI\r\nManila\r\nAtomAPI\r\nBloggerAPI\r\nVox\r\nTwitter\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.blogs.postPhoto.json": { + "method": { + "name": "flickr.blogs.postPhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "blog_id", + "optional": "1", + "_content": "The id of the blog to post to." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to blog" + }, + { + "name": "title", + "optional": "0", + "_content": "The blog post title" + }, + { + "name": "description", + "optional": "0", + "_content": "The blog post body" + }, + { + "name": "blog_password", + "optional": "1", + "_content": "The password for the blog (used when the blog does not have a stored password)." + }, + { + "name": "service", + "optional": "1", + "_content": "A Flickr supported blogging service. Instead of passing a blog id you can pass a service id and we'll post to the first blog of that service we find." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Blog not found", + "_content": "The blog id was not the id of a blog belonging to the calling user" + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id was not the id of a public photo" + }, + { + "code": "3", + "message": "Password needed", + "_content": "A password is not stored for the blog and one was not passed with the request" + }, + { + "code": "4", + "message": "Blog post failed", + "_content": "The blog posting failed (a blogging API failure of some sort)" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.cameras.getBrandModels.json": { + "method": { + "name": "flickr.cameras.getBrandModels", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Retrieve all the models for a given camera brand." + }, + "response": { + "_content": "\r\n \r\n \r\n iPhone 9000\r\n
\r\n 22.0\r\n 3.0\r\n 40.5\r\n Flash\r\n
\r\n \r\n http://farm3.staticflickr.com/1234/cameras/123456_model_small_123456.jpg\r\n http://farm3.staticflickr.com/1234/cameras/123456_model_large_123456.jpg\r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "brand", + "optional": "0", + "_content": "The ID of the requested brand (as returned from flickr.cameras.getBrands)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Brand not found", + "_content": "Unable to find the given brand ID." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.cameras.getBrands.json": { + "method": { + "name": "flickr.cameras.getBrands", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns all the brands of cameras that Flickr knows about." + }, + "response": { + "_content": "\r\n\r\n\tCanon\r\n\tNikon\r\n Apple\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.collections.getInfo.json": { + "method": { + "name": "flickr.collections.getInfo", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns information for a single collection. Currently can only be called by the collection owner, this may change." + }, + "response": { + "_content": "\r\nAll My Photos\r\nPhotos!\r\n\r\n\r\n\r\n\r\n....\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "collection_id", + "optional": "0", + "_content": "The ID of the collection to fetch information for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Collection not found", + "_content": "The requested collection could not be found or is not visible to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.collections.getTree.json": { + "method": { + "name": "flickr.collections.getTree", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a tree (or sub tree) of collections belonging to a given user." + }, + "response": { + "_content": "\r\n\r\n\r\n\r\n\r\n" + }, + "explanation": { + "_content": "A nested tree of collections, and the collections and sets they contain." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "collection_id", + "optional": "1", + "_content": "The ID of the collection to fetch a tree for, or zero to fetch the root collection. Defaults to zero." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The ID of the account to fetch the collection tree for. Deafults to the calling user." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The specified user could not be found." + }, + { + "code": "2", + "message": "Collection not found", + "_content": "The specified collection does not exist." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.commons.getInstitutions.json": { + "method": { + "name": "flickr.commons.getInstitutions", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Retrieves a list of the current Commons institutions." + }, + "response": { + "_content": "\r\n \r\n \r\n Institution\r\n \r\n http://example.com/\r\n http://example.com/commons/license\r\n http://flickr.com/photos/institution\r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.contacts.getList.json": { + "method": { + "name": "flickr.contacts.getList", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of contacts for the calling user." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "filter", + "optional": "1", + "_content": "An optional filter of the results. The following values are valid:
\r\n \r\n
\r\n\t
friends
\r\n\t
Only contacts who are friends (and not family)
\r\n\r\n\t
family
\r\n\t
Only contacts who are family (and not friends)
\r\n\r\n\t
both
\r\n\t
Only contacts who are both friends and family
\r\n\r\n\t
neither
\r\n\t
Only contacts who are neither friends nor family
\r\n
" + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000." + }, + { + "name": "sort", + "optional": "1", + "_content": "The order in which to sort the returned contacts. Defaults to name. The possible values are: name and time." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Invalid sort parameter.", + "_content": "The possible values are: name and time." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.contacts.getListRecentlyUploaded.json": { + "method": { + "name": "flickr.contacts.getListRecentlyUploaded", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return a list of contacts for a user who have recently uploaded photos along with the total count of photos uploaded.

\r\n\r\nThis method is still considered experimental. We don't plan for it to change or to go away but so long as this notice is present you should write your code accordingly." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date_lastupload", + "optional": "1", + "_content": "Limits the resultset to contacts that have uploaded photos since this date. The date should be in the form of a Unix timestamp.\r\n\r\nThe default offset is (1) hour and the maximum (24) hours. " + }, + { + "name": "filter", + "optional": "1", + "_content": "Limit the result set to all contacts or only those who are friends or family. Valid options are:\r\n\r\n\r\nDefault value is \"all\"." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.contacts.getPublicList.json": { + "method": { + "name": "flickr.contacts.getPublicList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the contact list for a user." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t\r\n" + }, + "explanation": { + "_content": "

See flickr.contacts.getList for an explanation of the response.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to fetch the contact list for." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The specified user NSID was not a valid user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.contacts.getTaggingSuggestions.json": { + "method": { + "name": "flickr.contacts.getTaggingSuggestions", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get suggestions for tagging people in photos based on the calling user's contacts." + }, + "response": { + "_content": "\r\n\r\n\t\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of contacts to return per page. If this argument is omitted, all contacts will be returned." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.favorites.add.json": { + "method": { + "name": "flickr.favorites.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Adds a photo to a user's favorites list." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add to the user's favorites." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "2", + "message": "Photo is owned by you", + "_content": "The photo belongs to the user and so cannot be added to their favorites." + }, + { + "code": "3", + "message": "Photo is already in favorites", + "_content": "The photo is already in the user's list of favorites." + }, + { + "code": "4", + "message": "User cannot see photo", + "_content": "The user does not have permission to add the photo to their favorites." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.favorites.getContext.json": { + "method": { + "name": "flickr.favorites.getContext", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns next and previous favorites for a photo in a user's favorites." + }, + "response": { + "_content": "\r\n3\r\n \r\n\r\n" + }, + "explanation": { + "_content": "

See flickr.photos.getContext

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch the context for." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The user who counts the photo as a favorite." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view." + }, + { + "code": "2", + "message": "User not found", + "_content": "The specified user was not found." + }, + { + "code": "3", + "message": "Photo not a favorite", + "_content": "The specified photo is not a favorite of the specified user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.favorites.getList.json": { + "method": { + "name": "flickr.favorites.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "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." + }, + { + "name": "min_fave_date", + "optional": "1", + "_content": "Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp." + }, + { + "name": "max_fave_date", + "optional": "1", + "_content": "Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The specified user NSID was not a valid flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.favorites.getPublicList.json": { + "method": { + "name": "flickr.favorites.getPublicList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of favorite public photos for the given user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The user to fetch the favorites list for." + }, + { + "name": "min_fave_date", + "optional": "1", + "_content": "Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp." + }, + { + "name": "max_fave_date", + "optional": "1", + "_content": "Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The specified user NSID was not a valid flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.favorites.remove.json": { + "method": { + "name": "flickr.favorites.remove", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Removes a photo from a user's favorites list." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to remove from the user's favorites." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not in favorites", + "_content": "The photo id passed was not in the user's favorites." + }, + { + "code": "2", + "message": "Cannot remove photo from that user's favorites", + "_content": "user_id was passed as an argument, but photo_id is not owned by the authenticated user." + }, + { + "code": "3", + "message": "User not found", + "_content": "Invalid user_id argument." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.addPhoto.json": { + "method": { + "name": "flickr.galleries.addPhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a photo to a gallery." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like flickr.galleries.getList, and flickr.galleries.getListForPhoto." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The photo ID to add to the gallery" + }, + { + "name": "comment", + "optional": "1", + "_content": "A short comment or story to accompany the photo." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameters was not included with your API call." + }, + { + "code": "2", + "message": "Invalid gallery ID", + "_content": "That gallery could not be found." + }, + { + "code": "3", + "message": "Invalid photo ID", + "_content": "The requested photo could not be found." + }, + { + "code": "4", + "message": "Invalid comment", + "_content": "The comment body could not be validated." + }, + { + "code": "5", + "message": "Failed to add photo", + "_content": "Unable to add the photo to the gallery." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.create.json": { + "method": { + "name": "flickr.galleries.create", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Create a new gallery for the calling user." + }, + "response": { + "_content": " \r\n" + }, + "explanation": { + "_content": "The ID of the newly created gallery, and its URL." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "title", + "optional": "0", + "_content": "The name of the gallery" + }, + { + "name": "description", + "optional": "0", + "_content": "A short description for the gallery" + }, + { + "name": "primary_photo_id", + "optional": "1", + "_content": "The first photo to add to your gallery" + }, + { + "name": "full_result", + "optional": "1", + "_content": "Get the result in the same format as galleries.getList" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more of the required parameters was missing from your API call." + }, + { + "code": "2", + "message": "Invalid title or description", + "_content": "The title or the description could not be validated." + }, + { + "code": "3", + "message": "Failed to add gallery", + "_content": "There was a problem creating the gallery." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.editMeta.json": { + "method": { + "name": "flickr.galleries.editMeta", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Modify the meta-data for a gallery." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The gallery ID to update." + }, + { + "name": "title", + "optional": "0", + "_content": "The new title for the gallery." + }, + { + "name": "description", + "optional": "1", + "_content": "The new description for the gallery." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameters was missing from your request." + }, + { + "code": "2", + "message": "Invalid title or description", + "_content": "The title or description arguments could not be validated." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.editPhoto.json": { + "method": { + "name": "flickr.galleries.editPhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit the comment for a gallery photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like flickr.galleries.getList, and flickr.galleries.getListForPhoto." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The photo ID to add to the gallery." + }, + { + "name": "comment", + "optional": "0", + "_content": "The updated comment the photo." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Invalid gallery ID", + "_content": "That gallery could not be found." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.editPhotos.json": { + "method": { + "name": "flickr.galleries.editPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Modify the photos in a gallery. Use this method to add, remove and re-order photos." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The id of the gallery to modify. The gallery must belong to the calling user." + }, + { + "name": "primary_photo_id", + "optional": "0", + "_content": "The id of the photo to use as the 'primary' photo for the gallery. This id must also be passed along in photo_ids list argument." + }, + { + "name": "photo_ids", + "optional": "0", + "_content": "A comma-delimited list of photo ids to include in the gallery. They will appear in the set in the order sent. This list must contain the primary photo id. This list of photos replaces the existing list." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.getInfo.json": { + "method": { + "name": "flickr.galleries.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "" + }, + "response": { + "_content": "\r\n\tCat Pictures I've Sent To Kevin Collins\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The gallery ID you are requesting information for." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.getList.json": { + "method": { + "name": "flickr.galleries.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return the list of galleries created by a user. Sorted from newest to oldest." + }, + "response": { + "_content": "\r\n \r\n I like me some black & white\r\n black and whites\r\n \r\n \r\n People Sleeping in Libraries\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to get a galleries list for. If none is specified, the calling user is assumed." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "primary_photo_extras", + "optional": "1", + "_content": "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" + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.getListForPhoto.json": { + "method": { + "name": "flickr.galleries.getListForPhoto", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return the list of galleries to which a photo has been added. Galleries are returned sorted by date which the photo was added to the gallery." + }, + "response": { + "_content": "\r\n \r\n Vivitar Ultra Wide & Slim Selection\r\n The cheap and cheerful camera that isn't quite as cheap as it used to be.\r\n \r\n \r\n Awesome Pics\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The ID of the photo to fetch a list of galleries for." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.galleries.getPhotos.json": { + "method": { + "name": "flickr.galleries.getPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return the list of photos for a gallery" + }, + "response": { + "_content": "\r\n\t\r\n\t\tbest cat picture ever!\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "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." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "gallery_id", + "optional": "0", + "_content": "The ID of the gallery of photos to return" + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.browse.json": { + "method": { + "name": "flickr.groups.browse", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Browse the group category tree, finding groups and sub-categories." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n\t \r\n\r\n" + }, + "explanation": { + "_content": "

The count attribute of the subcat element gives the number of groups inside the subcat.

\r\n\r\n

The members attribute of the group element gives the total number of members in the group. The online attribute gives a count of the members who are currently online. The inchat attribute gives a count of the number of people in the group's chat, regardless of whether they are members of the group.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "cat_id", + "optional": "1", + "_content": "The category id to fetch a list of groups and sub-categories for. If not specified, it defaults to zero, the root of the category tree." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Category not found", + "_content": "The value passed for cat_id was not a valid category id." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.replies.add.json": { + "method": { + "name": "flickr.groups.discuss.replies.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Post a new reply to a group discussion topic." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Pass in the group id to where the topic belongs. Can be NSID or group alias. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get faster performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID of the topic to post a comment to." + }, + { + "name": "message", + "optional": "0", + "_content": "The message to post to the topic." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid." + }, + { + "code": "2", + "message": "Cannot post to group", + "_content": "Either this account is not a member of the group, or discussion in this group is disabled.\r\n" + }, + { + "code": "3", + "message": "Missing required arguments", + "_content": "The topic_id and message are required." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.replies.delete.json": { + "method": { + "name": "flickr.groups.discuss.replies.delete", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "3", + "description": { + "_content": "Delete a reply from a group topic." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Pass in the group id to where the topic belongs. Can be NSID or group alias. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get faster performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID of the topic the post is in." + }, + { + "name": "reply_id", + "optional": "0", + "_content": "The ID of the reply to delete." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid." + }, + { + "code": "2", + "message": "Reply not found", + "_content": "The reply_id is invalid." + }, + { + "code": "3", + "message": "Cannot delete reply", + "_content": "Replies can only be edited by their owner." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.replies.edit.json": { + "method": { + "name": "flickr.groups.discuss.replies.edit", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit a topic reply." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Pass in the group id to where the topic belongs. Can be NSID or group alias. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get faster performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID of the topic the post is in." + }, + { + "name": "reply_id", + "optional": "0", + "_content": "The ID of the reply post to edit." + }, + { + "name": "message", + "optional": "0", + "_content": "The message to edit the post with." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid" + }, + { + "code": "2", + "message": "Reply not found", + "_content": "The reply_id is invalid." + }, + { + "code": "3", + "message": "Missing required arguments", + "_content": "The topic_id and reply_id are required." + }, + { + "code": "4", + "message": "Cannot edit reply", + "_content": "Replies can only be edited by their owner." + }, + { + "code": "5", + "message": "Cannot post to group", + "_content": "Either this account is not a member of the group, or discussion in this group is disabled." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.replies.getInfo.json": { + "method": { + "name": "flickr.groups.discuss.replies.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get information on a group topic reply." + }, + "response": { + "_content": "\r\n\r\n \r\n ...well, too bad.\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Pass in the group id to where the topic belongs. Can be NSID or group alias. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get faster performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID of the topic the post is in." + }, + { + "name": "reply_id", + "optional": "0", + "_content": "The ID of the reply to fetch." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid" + }, + { + "code": "2", + "message": "Reply not found", + "_content": "The reply_id is invalid" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.replies.getList.json": { + "method": { + "name": "flickr.groups.discuss.replies.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get a list of replies from a group discussion topic." + }, + "response": { + "_content": "\r\n \r\n \r\n <div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5080874079/" title="Star Wars 1 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4035/5080874079_684cf874e0_m.jpg" width="240" height="180" alt="Star Wars 1 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467846/" title="Star Wars 2 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4071/5081467846_2eec86176d_m.jpg" width="240" height="180" alt="Star Wars 2 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467886/" title="Star Wars 3 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4021/5081467886_d8cca6c8e8_m.jpg" width="240" height="180" alt="Star Wars 3 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467910/" title="Star Wars 4 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4084/5081467910_274bb11fdc_m.jpg" width="240" height="180" alt="Star Wars 4 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467948/" title="Star Wars 5 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4154/5081467948_1a5f200bc0_m.jpg" width="240" height="180" alt="Star Wars 5 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n \r\n \r\n *LOL* The universe is full of <a href="http://www.flickr.com/groups/visualstory/discuss/72157622533160886/">giant furry space monsters</a> it seems! Love it.\r\n \r\n \r\n Great work. Good focus on different aspects of scene in each frame. Funny ending-- even better that I didn't notice the cat right away! Being a hopeless Trekkie, I was wondering why Han was doing the Vulcan death grip on one of his allies....\r\n \r\n \r\n On a scale of 1 to 10 of awesome. This is a 15\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Pass in the group id to where the topic belongs. Can be NSID or group alias. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get faster performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID of the topic to fetch replies for." + }, + { + "name": "per_page", + "optional": "0", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.topics.add.json": { + "method": { + "name": "flickr.groups.discuss.topics.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Post a new discussion topic to a group." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID or path alias of the group to add a topic to.\r\n" + }, + { + "name": "subject", + "optional": "0", + "_content": "The topic subject." + }, + { + "name": "message", + "optional": "0", + "_content": "The topic message." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The group by that ID does not exist\r\n" + }, + { + "code": "2", + "message": "Cannot post to group", + "_content": "Either this account is not a member of the group, or discussion in this group is disabled." + }, + { + "code": "3", + "message": "Message is too long", + "_content": "The post message is too long." + }, + { + "code": "4", + "message": "Missing required arguments", + "_content": "Subject and message are required." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.topics.getInfo.json": { + "method": { + "name": "flickr.groups.discuss.topics.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get information about a group discussion topic." + }, + "response": { + "_content": "\r\n\r\n \r\n Is anyone still around in this group?\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "NSID or group alias of the group to which the topic belongs. Making this parameter optional for legacy reasons, but it is highly recommended to pass this in to get better performance. " + }, + { + "name": "topic_id", + "optional": "0", + "_content": "The ID for the topic to edit." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Topic not found", + "_content": "The topic_id is invalid" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.discuss.topics.getList.json": { + "method": { + "name": "flickr.groups.discuss.topics.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get a list of discussion topics in a group." + }, + "response": { + "_content": "\r\n \r\n \r\n <div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5080874079/" title="Star Wars 1 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4035/5080874079_684cf874e0_m.jpg" width="240" height="180" alt="Star Wars 1 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467846/" title="Star Wars 2 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4071/5081467846_2eec86176d_m.jpg" width="240" height="180" alt="Star Wars 2 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467886/" title="Star Wars 3 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4021/5081467886_d8cca6c8e8_m.jpg" width="240" height="180" alt="Star Wars 3 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467910/" title="Star Wars 4 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4084/5081467910_274bb11fdc_m.jpg" width="240" height="180" alt="Star Wars 4 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n\r\n<div><span class="photo_container pc_m bbml_img"><a href="/photos/53930889@N04/5081467948/" title="Star Wars 5 by Smallportfolio_jm08"><img class="notsowide" src="http://farm5.staticflickr.com/4154/5081467948_1a5f200bc0_m.jpg" width="240" height="180" alt="Star Wars 5 by Smallportfolio_jm08" class="pc_img" border="0" /></a></span></div>\r\n \r\n \r\n <a href="http://www.flickr.com/photos/nokinrocks/7120495637/"><img class="notsowide" src="http://farm9.staticflickr.com/8005/7120495637_fec0382b4b_n.jpg" width="320" height="256" alt="Step It Up" /></a>\r\n\r\n<a href="http://www.flickr.com/photos/nokinrocks/7122908705/"><img class="notsowide" src="http://farm8.staticflickr.com/7259/7122908705_3bef338378_n.jpg" width="240" height="320" alt="P1050351" /></a>\r\n\r\n<a href="http://www.flickr.com/photos/nokinrocks/7122922123/"><img class="notsowide" src="http://farm8.staticflickr.com/7052/7122922123_2bfcb6707c_n.jpg" width="214" height="320" alt="Frog On A Log" /></a>\r\n\r\n<a href="http://www.flickr.com/photos/nokinrocks/7122929521/"><img class="notsowide" src="http://farm8.staticflickr.com/7047/7122929521_8ffebdd424_n.jpg" width="320" height="200" alt="P1050397" /></a>\r\n\r\n<a href="http://www.flickr.com/photos/nokinrocks/7122916999/"><img class="notsowide" src="http://farm8.staticflickr.com/7200/7122916999_a7328f9dcc_n.jpg" width="320" height="261" alt="P1050361" /></a>\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID or path alias of the group to fetch information for." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The group_id is invalid" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.getInfo.json": { + "method": { + "name": "flickr.groups.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get information about a group." + }, + "response": { + "_content": "\r\n\tGNEverybody\r\n\tThe group for GNE players\r\n\t69\r\n\t3\r\n\t\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the group to fetch information for." + }, + { + "name": "group_path_alias", + "optional": "1", + "_content": "The path alias of the group. One of this or the group_id param is required" + }, + { + "name": "lang", + "optional": "1", + "_content": "The language of the group name and description to fetch. If the language is not found, the primary language of the group will be returned.\r\n\r\nValid values are the same as in feeds." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The group NSID passed did not refer to a group that the calling user can see - either an invalid group is or a group that can't be seen by the calling user." + }, + { + "code": "2", + "message": "Group is private", + "_content": "This is a private group." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.join.json": { + "method": { + "name": "flickr.groups.join", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Join a public group as a member." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the Group in question" + }, + { + "name": "accept_rules", + "optional": "1", + "_content": "If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "The group_id doesn't exist" + }, + { + "code": "2", + "message": "Group does not exist", + "_content": "The Group does not exist" + }, + { + "code": "3", + "message": "Group not availabie to the account", + "_content": "The authed account does not have permission to view/join the group." + }, + { + "code": "4", + "message": "Account is already in that group", + "_content": "The authed account has previously joined this group" + }, + { + "code": "5", + "message": "Membership in group is by invitation only.", + "_content": "Use flickr.groups.joinRequest to contact the administrations for an invitation." + }, + { + "code": "6", + "message": "User must accept the group rules before joining", + "_content": "The user must read and accept the rules before joining. Please see the accept_rules argument for this method." + }, + { + "code": "10", + "message": "Account in maximum number of groups", + "_content": "The account is a member of the maximum number of groups." + }, + { + "code": "11", + "message": "User unable to join", + "_content": "This user is unable to join this group." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.joinRequest.json": { + "method": { + "name": "flickr.groups.joinRequest", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Request to join a group that is invitation-only." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the group to request joining." + }, + { + "name": "message", + "optional": "0", + "_content": "Message to the administrators." + }, + { + "name": "accept_rules", + "optional": "0", + "_content": "If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "The group_id or message argument are missing." + }, + { + "code": "2", + "message": "Group does not exist", + "_content": "The Group does not exist" + }, + { + "code": "3", + "message": "Group not available to the account", + "_content": "The authed account does not have permission to view/join the group." + }, + { + "code": "4", + "message": "Account is already in that group", + "_content": "The authed account has previously joined this group" + }, + { + "code": "5", + "message": "Group is public and open", + "_content": "The group does not require an invitation to join, please use flickr.groups.join." + }, + { + "code": "6", + "message": "User must accept the group rules before joining", + "_content": "The user must read and accept the rules before joining. Please see the accept_rules argument for this method." + }, + { + "code": "7", + "message": "User has already requested to join that group", + "_content": "A request has already been sent and is pending approval." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.leave.json": { + "method": { + "name": "flickr.groups.leave", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "3", + "description": { + "_content": "Leave a group.\r\n\r\n

If the user is the only administrator left, and there are other members, the oldest member will be promoted to administrator.\r\n\r\n

If the user is the last person in the group, the group will be deleted." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the Group to leave" + }, + { + "name": "delete_photos", + "optional": "1", + "_content": "Delete all photos by this user from the group" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "The group_id doesn't exist" + }, + { + "code": "2", + "message": "Group does not exist", + "_content": "The group by that ID does not exist" + }, + { + "code": "3", + "message": "Account is not in that group", + "_content": "The user is not a member of the group that was specified" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.members.getList.json": { + "method": { + "name": "flickr.groups.members.getList", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of the members of a group. The call must be signed on behalf of a Flickr member, and the ability to see the group membership will be determined by the Flickr member's group privileges." + }, + "response": { + "_content": "\r\n\r\n\r\n\r\n\r\n...\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "Return a list of members for this group. The group must be viewable by the Flickr member on whose behalf the API call is made." + }, + { + "name": "membertypes", + "optional": "1", + "_content": "Comma separated list of member types\r\n\r\nBy default returns all types. (Returning super rare member type \"1: narwhal\" isn't supported by this API method)" + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of members to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.pools.add.json": { + "method": { + "name": "flickr.groups.pools.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a photo to a group's pool." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add to the group pool. The photo must belong to the calling user." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the group who's pool the photo is to be added to." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a photo owned by the caling user." + }, + { + "code": "2", + "message": "Group not found", + "_content": "The group id passed was not a valid id for a group the user is a member of." + }, + { + "code": "3", + "message": "Photo already in pool", + "_content": "The specified photo is already in the pool for the specified group." + }, + { + "code": "4", + "message": "Photo in maximum number of pools", + "_content": "The photo has already been added to the maximum allowed number of pools." + }, + { + "code": "5", + "message": "Photo limit reached", + "_content": "The user has already added the maximum amount of allowed photos to the pool." + }, + { + "code": "6", + "message": "Your Photo has been added to the Pending Queue for this Pool", + "_content": "The pool is moderated, and the photo has been added to the Pending Queue. If it is approved by a group administrator, it will be added to the pool." + }, + { + "code": "7", + "message": "Your Photo has already been added to the Pending Queue for this Pool", + "_content": "The pool is moderated, and the photo has already been added to the Pending Queue." + }, + { + "code": "8", + "message": "Content not allowed", + "_content": "The content has been disallowed from the pool by the group admin(s)." + }, + { + "code": "10", + "message": "Maximum number of photos in Group Pool", + "_content": "A group pool has reached the upper limit for the number of photos allowed." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.pools.getContext.json": { + "method": { + "name": "flickr.groups.pools.getContext", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns next and previous photos for a photo in a group pool." + }, + "response": { + "_content": " \r\n " + }, + "explanation": { + "_content": "

See flickr.photos.getContext

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch the context for." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The nsid of the group who's pool to fetch the photo's context for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view." + }, + { + "code": "2", + "message": "Photo not in pool", + "_content": "The specified photo is not in the specified group's pool." + }, + { + "code": "3", + "message": "Group not found", + "_content": "The specified group nsid was not a valid group or the caller does not have permission to view the group's pool." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.pools.getGroups.json": { + "method": { + "name": "flickr.groups.pools.getGroups", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of groups to which you can add photos." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n" + }, + "explanation": { + "_content": "

The privacy attribute is 1 for private groups, 2 for invite-only public groups and 3 for open public groups.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of groups to return per page. If this argument is omitted, it defaults to 400. The maximum allowed value is 400." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.pools.getPhotos.json": { + "method": { + "name": "flickr.groups.pools.getPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of pool photos for a given group, based on the permissions of the group and the user logged in (if any)." + }, + "response": { + "_content": "\r\n\t \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The id of the group who's pool you which to get the photo list for." + }, + { + "name": "tags", + "optional": "1", + "_content": "A tag to filter the pool with. At the moment only one tag at a time is supported." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The nsid of a user. Specifiying this parameter will retrieve for you only those photos that the user has contributed to the group pool." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The group id passed was not a valid group id." + }, + { + "code": "2", + "message": "You don't have permission to view this pool", + "_content": "The logged in user (if any) does not have permission to view the pool for this group." + }, + { + "code": "3", + "message": "Unknown user", + "_content": "The user specified by user_id does not exist." + }, + { + "code": "4", + "message": "Group/pool is member only", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.pools.remove.json": { + "method": { + "name": "flickr.groups.pools.remove", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove a photo from a group pool." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to remove from the group pool. The photo must either be owned by the calling user of the calling user must be an administrator of the group." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the group who's pool the photo is to removed from." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The group_id passed did not refer to a valid group." + }, + { + "code": "2", + "message": "Photo not in pool", + "_content": "The photo_id passed was not a valid id of a photo in the group pool." + }, + { + "code": "3", + "message": "Insufficient permission to remove photo", + "_content": "The calling user doesn't own the photo and is not an administrator of the group, so may not remove the photo from the pool." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.groups.search.json": { + "method": { + "name": "flickr.groups.search", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Search for groups. 18+ groups will only be returned for authenticated calls where the authenticated user is over 18." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "text", + "optional": "0", + "_content": "The text to search for." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of groups to return per page. If this argument is ommited, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is ommited, it defaults to 1. " + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "No text passed", + "_content": "The required text argument was ommited." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.interestingness.getList.json": { + "method": { + "name": "flickr.interestingness.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the list of interesting photos for the most recent day or a user-specified date." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "1", + "_content": "A specific date, formatted as YYYY-MM-DD, to return interesting photos for." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Not a valid date string.", + "_content": "The date string passed did not validate. All dates must be formatted : YYYY-MM-DD" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.machinetags.getNamespaces.json": { + "method": { + "name": "flickr.machinetags.getNamespaces", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of unique namespaces, optionally limited by a given predicate, in alphabetical order." + }, + "response": { + "_content": "\r\n aero\r\n flickr\r\n geo\r\n taxonomy\r\n upcoming\r\n\r\n" + }, + "explanation": { + "_content": "\"Usage\" gives you roughly how popular a machine tags, while \"predicates\" is the count of distinct predicates a namespace has." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "predicate", + "optional": "1", + "_content": "Limit the list of namespaces returned to those that have the following predicate." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Not a valid predicate.", + "_content": "Missing or invalid predicate argument." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.machinetags.getPairs.json": { + "method": { + "name": "flickr.machinetags.getPairs", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of unique namespace and predicate pairs, optionally limited by predicate or namespace, in alphabetical order." + }, + "response": { + "_content": "\r\n aero:airline\r\n aero:icao\r\n aero:model\r\n aero:tail\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "namespace", + "optional": "1", + "_content": "Limit the list of pairs returned to those that have the following namespace." + }, + { + "name": "predicate", + "optional": "1", + "_content": "Limit the list of pairs returned to those that have the following predicate." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Not a valid namespace", + "_content": "Missing or invalid namespace argument." + }, + { + "code": "2", + "message": "Not a valid predicate", + "_content": "Missing or invalid predicate argument." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.machinetags.getPredicates.json": { + "method": { + "name": "flickr.machinetags.getPredicates", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of unique predicates, optionally limited by a given namespace." + }, + "response": { + "_content": "\r\n elbow\r\n face\r\n hand\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "namespace", + "optional": "1", + "_content": "Limit the list of predicates returned to those that have the following namespace." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Not a valid namespace", + "_content": "Missing or invalid namespace argument." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.machinetags.getRecentValues.json": { + "method": { + "name": "flickr.machinetags.getRecentValues", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Fetch recently used (or created) machine tags values." + }, + "response": { + "_content": "\r\n maui chaff flower\r\n\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "namespace", + "optional": "1", + "_content": "A namespace that all values should be restricted to." + }, + { + "name": "predicate", + "optional": "1", + "_content": "A predicate that all values should be restricted to." + }, + { + "name": "added_since", + "optional": "1", + "_content": "Only return machine tags values that have been added since this timestamp, in epoch seconds. " + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.machinetags.getValues.json": { + "method": { + "name": "flickr.machinetags.getValues", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of unique values for a namespace and predicate." + }, + "response": { + "_content": "\r\n 123\r\n 456\r\n 789\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "namespace", + "optional": "0", + "_content": "The namespace that all values should be restricted to." + }, + { + "name": "predicate", + "optional": "0", + "_content": "The predicate that all values should be restricted to." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Not a valid namespace", + "_content": "Missing or invalid namespace argument." + }, + { + "code": "2", + "message": "Not a valid predicate", + "_content": "Missing or invalid predicate argument." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.panda.getList.json": { + "method": { + "name": "flickr.panda.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of Flickr pandas, from whom you can request photos using the flickr.panda.getPhotos API method.\r\n

\r\nMore information about the pandas can be found on the dev blog." + }, + "response": { + "_content": "\r\n ling ling\r\n hsing hsing\r\n wang wang\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.panda.getPhotos.json": { + "method": { + "name": "flickr.panda.getPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Ask the Flickr Pandas for a list of recent public (and \"safe\") photos.\r\n

\r\nMore information about the pandas can be found on the dev blog." + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n" + }, + "explanation": { + "_content": "When calling this API method please ensure that your code uses the lastupdate and interval attributes to determine when to request new photos. lastupdate is a Unix timestamp indicating when the list of photos was generated and interval is the number of seconds to wait before polling the Flickr API again." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "panda_name", + "optional": "0", + "_content": "The name of the panda to ask for photos from. There are currently three pandas named:

\r\n\r\n\r\n\r\n
You can fetch a list of all the current pandas using the flickr.panda.getList API method." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing.", + "_content": "One or more required parameters was not included with your request." + }, + { + "code": "2", + "message": "Unknown panda", + "_content": "You requested a panda we haven't met yet." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.findByEmail.json": { + "method": { + "name": "flickr.people.findByEmail", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a user's NSID, given their email address" + }, + "response": { + "_content": "\r\n\tStewart \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "find_email", + "optional": "0", + "_content": "The email address of the user to find (may be primary or secondary)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "No user with the supplied email address was found." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.findByUsername.json": { + "method": { + "name": "flickr.people.findByUsername", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a user's NSID, given their username." + }, + "response": { + "_content": "\r\n\tStewart \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "username", + "optional": "0", + "_content": "The username of the user to lookup." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "No user with the supplied username was found." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getGroups.json": { + "method": { + "name": "flickr.people.getGroups", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the list of groups a user is a member of." + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n \r\n" + }, + "explanation": { + "_content": "The admin attribute indicates whether the user is an administrator of the group. The eighteenplus attribute indicates if the group is visible to members over 18 only. The invite_only attribute indicates whether a user can join the group without administrator approval." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to fetch groups for." + }, + { + "name": "extras", + "optional": "1", + "_content": "A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: privacy, throttle, restrictions" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user id passed did not match a Flickr user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getInfo.json": { + "method": { + "name": "flickr.people.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get information about a user." + }, + "response": { + "_content": "\r\n\tbees\r\n\tCal Henderson\r\n eea6cd28e3d0003ab51b0058a684d94980b727ac\r\n\tVancouver, Canada\r\n\thttp://www.flickr.com/photos/bees/ \r\n\thttp://www.flickr.com/people/bees/ \r\n\t\r\n\t\t1071510391\r\n\t\t1900-09-02 09:11:24\r\n\t\t449\r\n\t\r\n" + }, + "explanation": { + "_content": "

The firstdate element contains the unix timestamp of the first photo uploaded by the user. The firstdatetaken element contains the mysql datetime of the first photo taken by the user.

\r\n

The iconserver element is used to build the url to the users' buddyicon - for more information please read the buddyicon guide.

\r\n

\r\nIf the API call is authenticated contact information will also be returned as attributes on the person element. contact, friend, and family are boolean flags describing the relationship between the authenticated user, and the person currently being inspected. revcontact, revfriend, and revfamily is the reciprocal relationship.\r\n

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to fetch information about." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user id passed did not match a Flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getLimits.json": { + "method": { + "name": "flickr.people.getLimits", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the photo and video limits that apply to the calling user account." + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "
    \r\n
  • photos/@maxdisplaypx: maximum size in pixels for photos displayed on the site (0 means that no limit is in place). No limit is placed on the dimension of photos uploaded.
    • \r\n
  • photos/@maxupload: maximum file size in bytes for photo uploads.
    • \r\n
  • videos/@maxduration: maximum duration in seconds of a video.
    • \r\n
  • videos/@maxupload: maximum file size in bytes for video uploads.
    • \r\n
\r\n\r\n

For more details, see the documentation about limits.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getPhotos.json": { + "method": { + "name": "flickr.people.getPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return photos from the given user's photostream. Only photos visible to the calling user will be returned. This method must be authenticated; to return public photos for a user, use flickr.people.getPublicPhotos." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user who's photos to return. A value of \"me\" will return the calling user's photos." + }, + { + "name": "safe_search", + "optional": "1", + "_content": "Safe search setting:\r\n\r\n
    \r\n
  • 1 for safe.
    • \r\n
  • 2 for moderate.
    • \r\n
  • 3 for restricted.
    • \r\n
\r\n\r\n(Please note: Un-authed calls can only see Safe content.)" + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "content_type", + "optional": "1", + "_content": "Content Type setting:\r\n
    \r\n
  • 1 for photos only.
    • \r\n
  • 2 for screenshots only.
    • \r\n
  • 3 for 'other' only.
    • \r\n
  • 4 for photos and screenshots.
    • \r\n
  • 5 for screenshots and 'other'.
    • \r\n
  • 6 for photos and 'other'.
    • \r\n
  • 7 for photos, screenshots, and 'other' (all).
    • \r\n
" + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
" + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "" + }, + { + "code": "2", + "message": "Unknown user", + "_content": "A user_id was passed which did not match a valid flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getPhotosOf.json": { + "method": { + "name": "flickr.people.getPhotosOf", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of photos containing a particular Flickr member." + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

This method returns a variant of the standard photo list xml.

\r\n\r\n

For queries about a member other than the currently authenticated one, pagination data (\"total\" and \"pages\" attributes) will not be available.

\r\n\r\n

Instead, the element will contain a boolean value 'has_next_page' which will tell you whether or not there are more photos to fetch.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user you want to find photos of. A value of \"me\" will search against photos of the calling user, for authenticated calls." + }, + { + "name": "owner_id", + "optional": "1", + "_content": "An NSID of a Flickr member. This will restrict the list of photos to those taken by that member." + }, + { + "name": "extras", + "optional": 1, + "_content": "A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, date_person_added, 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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found.", + "_content": "A user_id was passed which did not match a valid flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getPublicGroups.json": { + "method": { + "name": "flickr.people.getPublicGroups", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the list of public groups a user is a member of." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n" + }, + "explanation": { + "_content": "

The admin attribute indicates whether the user is an administrator of the group. The eighteenplus attribute indicates if the group is visible to members over 18 only. The invite_only attribute indicates whether a user can join the group without administrator approval.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to fetch groups for." + }, + { + "name": "invitation_only", + "optional": "1", + "_content": "Include public groups that require an invitation or administrator approval to join." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user id passed did not match a Flickr user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getPublicPhotos.json": { + "method": { + "name": "flickr.people.getPublicPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get a list of public photos for the given user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user who's photos to return." + }, + { + "name": "safe_search", + "optional": "1", + "_content": "Safe search setting:\r\n\r\n
    \r\n
  • 1 for safe.
    • \r\n
  • 2 for moderate.
    • \r\n
  • 3 for restricted.
    • \r\n
\r\n\r\n(Please note: Un-authed calls can only see Safe content.)" + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user NSID passed was not a valid user NSID." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.people.getUploadStatus.json": { + "method": { + "name": "flickr.people.getUploadStatus", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns information for the calling user related to photo uploads." + }, + "response": { + "_content": "\r\n\tBees \r\n\t \r\n\t \r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

Bandwidth and filesize numbers are provided in bytes and kilobytes. If you're using 32bit numbers, stick to using the kilobyte values - they shouldn't ever exceed 2/4 billion, while the byte values will.

\r\n\r\n

Bandwidth is specified in bytes/kb per month.

\r\n\r\n\r\n

All accounts display \"lots\" for the number of remaining sets, but remains in the response for backwards compatibility.

\r\n\r\n

Pro accounts display \"lots\" for the number of remaining videos, while free users will display 0, 1, or 2.

\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.addTags.json": { + "method": { + "name": "flickr.photos.addTags", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add tags to a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add tags to." + }, + { + "name": "tags", + "optional": "0", + "_content": "The tags to add to the photo." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a photo that the calling user can add tags to. It could be an invalid id, or the user may not have permission to add tags to it." + }, + { + "code": "2", + "message": "Maximum number of tags reached", + "_content": "The maximum number of tags for the photo has been reached - no more tags can be added. If the current count is less than the maximum, but adding all of the tags for this request would go over the limit, the whole request is ignored. I.E. when you get this message, none of the requested tags have been added." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.comments.addComment.json": { + "method": { + "name": "flickr.photos.comments.addComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add comment to a photo as the currently authenticated user." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add a comment to." + }, + { + "name": "comment_text", + "optional": "0", + "_content": "Text of the comment" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found.", + "_content": "The photo id passed was not a valid photo id" + }, + { + "code": "8", + "message": "Blank comment.", + "_content": "Comment text can not be blank" + }, + { + "code": "9", + "message": "User is posting comments too fast.", + "_content": "The user has reached the limit for number of comments posted during a specific time period. Wait a bit and try again." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.comments.deleteComment.json": { + "method": { + "name": "flickr.photos.comments.deleteComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Delete a comment as the currently authenticated user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "comment_id", + "optional": "0", + "_content": "The id of the comment to edit." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found.", + "_content": "The requested comment is against a photo which no longer exists." + }, + { + "code": "2", + "message": "Comment not found.", + "_content": "The comment id passed was not a valid comment id" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.comments.editComment.json": { + "method": { + "name": "flickr.photos.comments.editComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit the text of a comment as the currently authenticated user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "comment_id", + "optional": "0", + "_content": "The id of the comment to edit." + }, + { + "name": "comment_text", + "optional": "0", + "_content": "Update the comment to this text." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found.", + "_content": "The requested comment is against a photo which no longer exists." + }, + { + "code": "2", + "message": "Comment not found.", + "_content": "The comment id passed was not a valid comment id" + }, + { + "code": "8", + "message": "Blank comment.", + "_content": "Comment text can not be blank" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.comments.getList.json": { + "method": { + "name": "flickr.photos.comments.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the comments for a photo" + }, + "response": { + "_content": "\r\n Umm, I'm not sure, can I get back to you on that one?\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch comments for." + }, + { + "name": "min_comment_date", + "optional": "1", + "_content": "Minimum date that a a comment was added. The date should be in the form of a unix timestamp." + }, + { + "name": "max_comment_date", + "optional": "1", + "_content": "Maximum date that a comment was added. The date should be in the form of a unix timestamp." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.comments.getRecentForContacts.json": { + "method": { + "name": "flickr.photos.comments.getRecentForContacts", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return the list of photos belonging to your contacts that have been commented on recently." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date_lastcomment", + "optional": "1", + "_content": "Limits the resultset to photos that have been commented on since this date. The date should be in the form of a Unix timestamp.

\r\nThe default, and maximum, offset is (1) hour.\r\n\r\n\r\n" + }, + { + "name": "contacts_filter", + "optional": "1", + "_content": "A comma-separated list of contact NSIDs to limit the scope of the query to." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.delete.json": { + "method": { + "name": "flickr.photos.delete", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "3", + "description": { + "_content": "Delete a photo from flickr." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to delete." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was not the id of a photo belonging to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.batchCorrectLocation.json": { + "method": { + "name": "flickr.photos.geo.batchCorrectLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Correct the places hierarchy for all the photos for a user at a given latitude, longitude and accuracy.

\r\n\r\nBatch corrections are processed in a delayed queue so it may take a few minutes before the changes are reflected in a user's photos." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "lat", + "optional": "0", + "_content": "The latitude of the photos to be update whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated." + }, + { + "name": "lon", + "optional": "0", + "_content": "The longitude of the photos to be updated whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated." + }, + { + "name": "accuracy", + "optional": "0", + "_content": "Recorded accuracy level of the photos to be updated. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": "2", + "message": "Not a valid latitude", + "_content": "The latitude argument failed validation." + }, + { + "code": "3", + "message": "Not a valid longitude", + "_content": "The longitude argument failed validation." + }, + { + "code": "4", + "message": "Not a valid accuracy", + "_content": "The accuracy argument failed validation." + }, + { + "code": "5", + "message": "Not a valid Places ID", + "_content": "An invalid Places (or WOE) ID was passed with the API call." + }, + { + "code": "6", + "message": "No photos geotagged at that location", + "_content": "There were no geotagged photos found for the authed user at the supplied latitude, longitude and accuracy." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.correctLocation.json": { + "method": { + "name": "flickr.photos.geo.correctLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The ID of the photo whose WOE location is being corrected." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "foursquare_id", + "optional": "0", + "_content": "The venue ID for a Foursquare location. (If not passed in with correction, any existing foursquare venue will be removed)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User has not configured default viewing settings for location data.", + "_content": "Before users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference at http://www.flickr.com/account/geo/privacy/" + }, + { + "code": "2", + "message": "Missing place ID", + "_content": "No place ID was passed to the method" + }, + { + "code": "3", + "message": "Not a valid place ID", + "_content": "The place ID passed to the method could not be identified" + }, + { + "code": "4", + "message": "Server error correcting location.", + "_content": "There was an error trying to correct the location." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.getLocation.json": { + "method": { + "name": "flickr.photos.geo.getLocation", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the geo data (latitude and longitude and the accuracy level) for a photo." + }, + "response": { + "_content": "\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo you want to retrieve location data for." + }, + { + "name": "extras", + "optional": "1", + "_content": "Extra flags." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found.", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Photo has no location information.", + "_content": "The photo requested has no location data or is not viewable by the calling user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.getPerms.json": { + "method": { + "name": "flickr.photos.geo.getPerms", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get permissions for who may view geo data for a photo." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get permissions for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Photo has no location information", + "_content": "The photo requested has no location data or is not viewable by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.photosForLocation.json": { + "method": { + "name": "flickr.photos.geo.photosForLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return a list of photos for the calling user at a specific latitude, longitude and accuracy" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "lat", + "optional": "0", + "_content": "The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated." + }, + { + "name": "lon", + "optional": "0", + "_content": "The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "One or more required arguments was missing from the method call." + }, + { + "code": "2", + "message": "Not a valid latitude", + "_content": "The latitude argument failed validation." + }, + { + "code": "3", + "message": "Not a valid longitude", + "_content": "The longitude argument failed validation." + }, + { + "code": "4", + "message": "Not a valid accuracy", + "_content": "The accuracy argument failed validation." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.removeLocation.json": { + "method": { + "name": "flickr.photos.geo.removeLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Removes the geo data associated with a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo you want to remove location data from." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Photo has no location information", + "_content": "The specified photo has not been geotagged - there is nothing to remove." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.setContext.json": { + "method": { + "name": "flickr.photos.geo.setContext", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Indicate the state of a photo's geotagginess beyond latitude and longitude.

\r\nNote : photos passed to this method must already be geotagged (using the flickr.photos.geo.setLocation method)." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set context data for." + }, + { + "name": "context", + "optional": "0", + "_content": "Context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to indicate that a photo was taken \"indoors\" or \"outdoors\".

\r\nThe current list of context IDs is :

\r\n
    \r\n
  • 0, not defined.
    • \r\n
  • 1, indoors.
    • \r\n
  • 2, outdoors.
    • \r\n
" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Not a valid context", + "_content": "The context ID passed to the method is invalid." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.setLocation.json": { + "method": { + "name": "flickr.photos.geo.setLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo.\r\n\r\nBefore users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference at http://www.flickr.com/account/geo/privacy/. If a user has not set this preference, the API method will return an error." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set location data for." + }, + { + "name": "lat", + "optional": "0", + "_content": "The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated." + }, + { + "name": "lon", + "optional": "0", + "_content": "The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified." + }, + { + "name": "context", + "optional": "1", + "_content": "Context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to indicate that a photo was taken \"indoors\" or \"outdoors\".

\r\nThe current list of context IDs is :

\r\n
    \r\n
  • 0, not defined.
    • \r\n
  • 1, indoors.
    • \r\n
  • 2, outdoors.
    • \r\n

\r\nThe default context for geotagged photos is 0, or \"not defined\"\r\n" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Required arguments missing.", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": "3", + "message": "Not a valid latitude.", + "_content": "The latitude argument failed validation." + }, + { + "code": "4", + "message": "Not a valid longitude.", + "_content": "The longitude argument failed validation." + }, + { + "code": "5", + "message": "Not a valid accuracy.", + "_content": "The accuracy argument failed validation." + }, + { + "code": "6", + "message": "Server error.", + "_content": "There was an unexpected problem setting location information to the photo." + }, + { + "code": "7", + "message": "User has not configured default viewing settings for location data.", + "_content": "Before users may assign location data to a photo they must define who, by default, may view that information. Users can edit this preference at http://www.flickr.com/account/geo/privacy/" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.geo.setPerms.json": { + "method": { + "name": "flickr.photos.geo.setPerms", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the permission for who may view the geo data associated with a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "is_public", + "optional": "0", + "_content": "1 to set viewing permissions for the photo's location data to public, 0 to set it to private." + }, + { + "name": "is_contact", + "optional": "0", + "_content": "1 to set viewing permissions for the photo's location data to contacts, 0 to set it to private." + }, + { + "name": "is_friend", + "optional": "0", + "_content": "1 to set viewing permissions for the photo's location data to friends, 0 to set it to private." + }, + { + "name": "is_family", + "optional": "0", + "_content": "1 to set viewing permissions for the photo's location data to family, 0 to set it to private." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get permissions for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Photo has no location information", + "_content": "The photo requested has no location data or is not viewable by the calling user." + }, + { + "code": "3", + "message": "Required arguments missing.", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getAllContexts.json": { + "method": { + "name": "flickr.photos.getAllContexts", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns all visible sets and pools the photo belongs to." + }, + "response": { + "_content": "\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The photo to return information for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a valid photo." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getContactsPhotos.json": { + "method": { + "name": "flickr.photos.getContactsPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Fetch a list of recent photos from the calling users' contacts." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "count", + "optional": "1", + "_content": "Number of photos to return. Defaults to 10, maximum 50. This is only used if single_photo is not passed." + }, + { + "name": "just_friends", + "optional": "1", + "_content": "set as 1 to only show photos from friends and family (excluding regular contacts)." + }, + { + "name": "single_photo", + "optional": "1", + "_content": "Only fetch one photo (the latest) per contact, instead of all photos in chronological order." + }, + { + "name": "include_self", + "optional": "1", + "_content": "Set to 1 to include photos from the calling user." + }, + { + "name": "extras", + "optional": "1", + "_content": "A comma-delimited list of extra information to fetch for each returned record. Currently supported fields include: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update. For more information see extras under flickr.photos.search." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getContactsPublicPhotos.json": { + "method": { + "name": "flickr.photos.getContactsPublicPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Fetch a list of recent public photos from a users' contacts." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to fetch photos for." + }, + { + "name": "count", + "optional": "1", + "_content": "Number of photos to return. Defaults to 10, maximum 50. This is only used if single_photo is not passed." + }, + { + "name": "just_friends", + "optional": "1", + "_content": "set as 1 to only show photos from friends and family (excluding regular contacts)." + }, + { + "name": "single_photo", + "optional": "1", + "_content": "Only fetch one photo (the latest) per contact, instead of all photos in chronological order." + }, + { + "name": "include_self", + "optional": "1", + "_content": "Set to 1 to include photos from the user specified by user_id." + }, + { + "name": "extras", + "optional": "1", + "_content": "A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user NSID passed was not a valid user NSID." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getContext.json": { + "method": { + "name": "flickr.photos.getContext", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns next and previous photos for a photo in a photostream." + }, + "response": { + "_content": " \r\n " + }, + "explanation": { + "_content": "

When either the previous of next photo is unavailable, the element is still returned, but contains id=\"0\"

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch the context for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getCounts.json": { + "method": { + "name": "flickr.photos.getCounts", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Gets a list of photo counts for the given date ranges for the calling user." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "dates", + "optional": "1", + "_content": "A comma delimited list of unix timestamps, denoting the periods to return counts for. They should be specified smallest first." + }, + { + "name": "taken_dates", + "optional": "1", + "_content": "A comma delimited list of mysql datetimes, denoting the periods to return counts for. They should be specified smallest first." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "No dates specified", + "_content": "Neither dates nor taken_dates were specified." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getExif.json": { + "method": { + "name": "flickr.photos.getExif", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Retrieves a list of EXIF/TIFF/GPS tags for a given photo. The calling user must have permission to view the photo." + }, + "response": { + "_content": "\r\n\t\r\n\t\tCanon\r\n\t\r\n\t\r\n\t\t90/10\r\n\t\tf/9\r\n\t\r\n\t\r\n\t\t64/1, 42/1, 4414/100\r\n\t\t64° 42' 44.14\"\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

The <clean> element contains a pretty-formatted version of the tag where availabale.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch information for." + }, + { + "name": "secret", + "optional": "1", + "_content": "The secret for the photo. If the correct secret is passed then permissions checking is skipped. This enables the 'sharing' of individual photos by passing around the id and secret." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": "2", + "message": "Permission denied", + "_content": "The owner of the photo does not want to share EXIF data." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getFavorites.json": { + "method": { + "name": "flickr.photos.getFavorites", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the list of people who have favorited a given photo." + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The ID of the photo to fetch the favoriters list for." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of usres to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The specified photo does not exist, or the calling user does not have permission to view it." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getInfo.json": { + "method": { + "name": "flickr.photos.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get information about a photo. The calling user must have permission to view the photo." + }, + "response": { + "_content": "\r\n\t\r\n\torford_castle_taster\r\n\thello!\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t1\r\n\t\r\n\t\tfoo\r\n\t\r\n\t\r\n\t\twooyay\r\n\t\thoopla\r\n\t\r\n\t\r\n\t\thttp://www.flickr.com/photos/bees/2733/ \r\n\t\r\n" + }, + "explanation": { + "_content": "

The <permissions> element is only returned for photos owned by the calling user. The isfavorite attribute only makes sense for logged in users who don't own the photo. The rotation attribute is the current clockwise rotation, in degrees, by which the smaller image sizes differ from the original image.

\r\n\r\n

The <date> element's lastupdate attribute is a Unix timestamp indicating the last time the photo, or any of its metadata (tags, comments, etc.) was modified.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get information for." + }, + { + "name": "secret", + "optional": "1", + "_content": "The secret for the photo. If the correct secret is passed then permissions checking is skipped. This enables the 'sharing' of individual photos by passing around the id and secret." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found.", + "_content": "The photo id was either invalid or was for a photo not viewable by the calling user." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getNotInSet.json": { + "method": { + "name": "flickr.photos.getNotInSet", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of your photos that are not part of any sets." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getPerms.json": { + "method": { + "name": "flickr.photos.getPerms", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get permissions for a photo." + }, + "response": { + "_content": " " + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get permissions for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id of a photo belonging to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getRecent.json": { + "method": { + "name": "flickr.photos.getRecent", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of the latest public photos uploaded to flickr." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "bad value for jump_to, must be valid photo id.", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getSizes.json": { + "method": { + "name": "flickr.photos.getSizes", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the available sizes for a photo. The calling user must have permission to view the photo." + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch size information for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "2", + "message": "Permission denied", + "_content": "The calling user does not have permission to view the photo." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getUntagged.json": { + "method": { + "name": "flickr.photos.getUntagged", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of your photos with no tags." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getWithGeoData.json": { + "method": { + "name": "flickr.photos.getWithGeoData", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of your geo-tagged photos." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "sort", + "optional": "1", + "_content": "The order in which to sort returned photos. Deafults to date-posted-desc. The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, and interestingness-asc." + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.getWithoutGeoData.json": { + "method": { + "name": "flickr.photos.getWithoutGeoData", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of your photos which haven't been geo-tagged." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "sort", + "optional": "1", + "_content": "The order in which to sort returned photos. Deafults to date-posted-desc. The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, and interestingness-asc." + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.licenses.getInfo.json": { + "method": { + "name": "flickr.photos.licenses.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Fetches a list of available photo licenses for Flickr." + }, + "response": { + "_content": "\r\n \r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n\t \r\n\t\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.licenses.setLicense.json": { + "method": { + "name": "flickr.photos.licenses.setLicense", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Sets the license for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The photo to update the license for." + }, + { + "name": "license_id", + "optional": "0", + "_content": "The license to apply, or 0 (zero) to remove the current license. Note : as of this writing the \"no known copyright restrictions\" license (7) is not a valid argument." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The specified id was not the id of a valif photo owner by the calling user." + }, + { + "code": "2", + "message": "License not found", + "_content": "The license id was not valid." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.notes.add.json": { + "method": { + "name": "flickr.photos.notes.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a note to a photo. Coordinates and sizes are in pixels, based on the 500px image size shown on individual photo pages." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add a note to" + }, + { + "name": "note_x", + "optional": "0", + "_content": "The left coordinate of the note" + }, + { + "name": "note_y", + "optional": "0", + "_content": "The top coordinate of the note" + }, + { + "name": "note_w", + "optional": "0", + "_content": "The width of the note" + }, + { + "name": "note_h", + "optional": "0", + "_content": "The height of the note" + }, + { + "name": "note_text", + "optional": "0", + "_content": "The description of the note" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id" + }, + { + "code": "2", + "message": "User cannot add notes", + "_content": "The calling user does not have permission to add a note to this photo" + }, + { + "code": "3", + "message": "Missing required arguments", + "_content": "One or more of the required arguments were not supplied." + }, + { + "code": "4", + "message": "Maximum number of notes reached", + "_content": "The maximum number of notes for the photo has been reached." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.notes.delete.json": { + "method": { + "name": "flickr.photos.notes.delete", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Delete a note from a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "note_id", + "optional": "0", + "_content": "The id of the note to delete" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Note not found", + "_content": "The note id passed was not a valid note id" + }, + { + "code": "2", + "message": "User cannot delete note", + "_content": "The calling user does not have permission to delete the specified note" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.notes.edit.json": { + "method": { + "name": "flickr.photos.notes.edit", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit a note on a photo. Coordinates and sizes are in pixels, based on the 500px image size shown on individual photo pages.\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "note_id", + "optional": "0", + "_content": "The id of the note to edit" + }, + { + "name": "note_x", + "optional": "0", + "_content": "The left coordinate of the note" + }, + { + "name": "note_y", + "optional": "0", + "_content": "The top coordinate of the note" + }, + { + "name": "note_w", + "optional": "0", + "_content": "The width of the note" + }, + { + "name": "note_h", + "optional": "0", + "_content": "The height of the note" + }, + { + "name": "note_text", + "optional": "0", + "_content": "The description of the note" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Note not found", + "_content": "The note id passed was not a valid note id" + }, + { + "code": "2", + "message": "User cannot edit note", + "_content": "The calling user does not have permission to edit the specified note" + }, + { + "code": "3", + "message": "Missing required arguments", + "_content": "One or more of the required arguments were not supplied." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.people.add.json": { + "method": { + "name": "flickr.photos.people.add", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a person to a photo. Coordinates and sizes of boxes are optional; they are measured in pixels, based on the 500px image size shown on individual photo pages." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add a person to." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the user to add to the photo." + }, + { + "name": "person_x", + "optional": "1", + "_content": "The left-most pixel co-ordinate of the box around the person." + }, + { + "name": "person_y", + "optional": "1", + "_content": "The top-most pixel co-ordinate of the box around the person." + }, + { + "name": "person_w", + "optional": "1", + "_content": "The width (in pixels) of the box around the person." + }, + { + "name": "person_h", + "optional": "1", + "_content": "The height (in pixels) of the box around the person." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Person not found", + "_content": "The NSID passed was not a valid user id." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "3", + "message": "User cannot add this person to photos", + "_content": "The person being added to the photo does not allow the calling user to add them." + }, + { + "code": "4", + "message": "User cannot add people to that photo", + "_content": "The owner of the photo doesn't allow the calling user to add people to their photos." + }, + { + "code": "5", + "message": "Person can't be tagged in that photo", + "_content": "The person being added to the photo does not want to be identified in this photo." + }, + { + "code": "6", + "message": "Some co-ordinate paramters were blank", + "_content": "Not all of the co-ordinate parameters (person_x, person_y, person_w, person_h) were passed with valid values." + }, + { + "code": "7", + "message": "Can't add that person to a non-public photo", + "_content": "You can only add yourself to another member's non-public photos." + }, + { + "code": "8", + "message": "Too many people in that photo", + "_content": "The maximum number of people has already been added to the photo." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.people.delete.json": { + "method": { + "name": "flickr.photos.people.delete", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove a person from a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to remove a person from." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the person to remove from the photo." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Person not found", + "_content": "The NSID passed was not a valid user id." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "3", + "message": "User cannot remove that person", + "_content": "The calling user did not have permission to remove this person from this photo." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.people.deleteCoords.json": { + "method": { + "name": "flickr.photos.people.deleteCoords", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove the bounding box from a person in a photo" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to edit a person in." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the person whose bounding box you want to remove." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Person not found", + "_content": "The NSID passed was not a valid user id." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "3", + "message": "User cannot edit that person in that photo", + "_content": "The calling user is neither the person depicted in the photo nor the person who added the bounding box." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.people.editCoords.json": { + "method": { + "name": "flickr.photos.people.editCoords", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit the bounding box of an existing person on a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to edit a person in." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The NSID of the person to edit in a photo." + }, + { + "name": "person_x", + "optional": "0", + "_content": "The left-most pixel co-ordinate of the box around the person." + }, + { + "name": "person_y", + "optional": "0", + "_content": "The top-most pixel co-ordinate of the box around the person." + }, + { + "name": "person_w", + "optional": "0", + "_content": "The width (in pixels) of the box around the person." + }, + { + "name": "person_h", + "optional": "0", + "_content": "The height (in pixels) of the box around the person." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Person not found", + "_content": "The NSID passed was not a valid user id." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": "3", + "message": "User cannot edit that person in that photo", + "_content": "The calling user did not originally add this person to the photo, and is not the person in question." + }, + { + "code": "4", + "message": "Some co-ordinate paramters were blank", + "_content": "Not all of the co-ordinate parameters (person_x, person_y, person_w, person_h) were passed with valid values." + }, + { + "code": "5", + "message": "No co-ordinates given", + "_content": "None of the co-ordinate parameters were valid." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.people.getList.json": { + "method": { + "name": "flickr.photos.people.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get a list of people in a given photo." + }, + "response": { + "_content": "\r\n \r\n" + }, + "explanation": { + "_content": "x, y, w and h correspond to the coordinates of the \"bounding box\" around a person in a photo. Since these co-ordinates are optional, these elements may not be present for every person." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get a list of people for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.recentlyUpdated.json": { + "method": { + "name": "flickr.photos.recentlyUpdated", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "

Return a list of your photos that have been recently created or which have been recently modified.

\r\n\r\n

Recently modified may mean that the photo's metadata (title, description, tags) may have been changed or a comment has been added (or just modified somehow :-)

" + }, + "response": { + "_content": "\r\n \r\n \r\n" + }, + "explanation": { + "_content": "

Photos are sorted by their date updated timestamp, in descending order.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "min_date", + "optional": "0", + "_content": "A Unix timestamp or any English textual datetime description indicating the date from which modifications should be compared." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required argument missing.", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": "2", + "message": "Not a valid date", + "_content": "The date argument did not pass validation." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.removeTag.json": { + "method": { + "name": "flickr.photos.removeTag", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove a tag from a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tag_id", + "optional": "0", + "_content": "The tag to remove from the photo. This parameter should contain a tag id, as returned by flickr.photos.getInfo." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Tag not found", + "_content": "The calling user doesn't have permission to delete the specified tag. This could mean it belongs to someone else, or doesn't exist." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.search.json": { + "method": { + "name": "flickr.photos.search", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of photos matching some criteria. Only photos visible to the calling user will be returned. To return private or semi-private photos, the caller must be authenticated with 'read' permissions, and have permission to view the photos. Unauthenticated calls will only return public photos." + }, + "explanation": { + "_content": "Please note that Flickr will return at most the first 4,000 results for any given search query. If this is an issue, we recommend trying a more specific query." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user who's photo to search. If this parameter isn't passed then everybody's public photos will be searched. A value of \"me\" will search against the calling user's photos for authenticated calls." + }, + { + "name": "tags", + "optional": "1", + "_content": "A comma-delimited list of tags. Photos with one or more of the tags listed will be returned. You can exclude results that match a term by prepending it with a - character." + }, + { + "name": "tag_mode", + "optional": "1", + "_content": "Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified." + }, + { + "name": "text", + "optional": "1", + "_content": "A free text search. Photos who's title, description or tags contain the text will be returned. You can exclude results that match a term by prepending it with a - character." + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp." + }, + { + "name": "license", + "optional": "1", + "_content": "The license id for photos (for possible values see the flickr.photos.licenses.getInfo method). Multiple licenses may be comma-separated." + }, + { + "name": "sort", + "optional": "1", + "_content": "The order in which to sort returned photos. Deafults to date-posted-desc (unless you are doing a radial geo query, in which case the default sorting is by ascending distance from the point specified). The possible values are: date-posted-asc, date-posted-desc, date-taken-asc, date-taken-desc, interestingness-desc, interestingness-asc, and relevance." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "bbox", + "optional": "1", + "_content": "A comma-delimited list of 4 values defining the Bounding Box of the area that will be searched.\r\n

\r\nThe 4 values represent the bottom-left corner of the box and the top-right corner, minimum_longitude, minimum_latitude, maximum_longitude, maximum_latitude.\r\n

\r\nLongitude has a range of -180 to 180 , latitude of -90 to 90. Defaults to -180, -90, 180, 90 if not specified.\r\n

\r\nUnlike standard photo queries, geo (or bounding box) queries will only return 250 results per page.\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Recorded accuracy level of the location information. Current range is 1-16 : \r\n\r\n
    \r\n
  • World level is 1
    • \r\n
  • Country is ~3
    • \r\n
  • Region is ~6
    • \r\n
  • City is ~11
    • \r\n
  • Street is ~16
    • \r\n
\r\n\r\nDefaults to maximum value if not specified." + }, + { + "name": "safe_search", + "optional": "1", + "_content": "Safe search setting:\r\n\r\n
    \r\n
  • 1 for safe.
    • \r\n
  • 2 for moderate.
    • \r\n
  • 3 for restricted.
    • \r\n
\r\n\r\n(Please note: Un-authed calls can only see Safe content.)" + }, + { + "name": "content_type", + "optional": "1", + "_content": "Content Type setting:\r\n
    \r\n
  • 1 for photos only.
    • \r\n
  • 2 for screenshots only.
    • \r\n
  • 3 for 'other' only.
    • \r\n
  • 4 for photos and screenshots.
    • \r\n
  • 5 for screenshots and 'other'.
    • \r\n
  • 6 for photos and 'other'.
    • \r\n
  • 7 for photos, screenshots, and 'other' (all).
    • \r\n
" + }, + { + "name": "machine_tags", + "optional": "1", + "_content": "Aside from passing in a fully formed machine tag, there is a special syntax for searching on specific properties :\r\n\r\n
    \r\n
  • Find photos using the 'dc' namespace : \"machine_tags\" => \"dc:\"
    • \r\n\r\n
  • Find photos with a title in the 'dc' namespace : \"machine_tags\" => \"dc:title=\"
    • \r\n\r\n
  • Find photos titled \"mr. camera\" in the 'dc' namespace : \"machine_tags\" => \"dc:title=\\\"mr. camera\\\"
    • \r\n\r\n
  • Find photos whose value is \"mr. camera\" : \"machine_tags\" => \"*:*=\\\"mr. camera\\\"\"
    • \r\n\r\n
  • Find photos that have a title, in any namespace : \"machine_tags\" => \"*:title=\"
    • \r\n\r\n
  • Find photos that have a title, in any namespace, whose value is \"mr. camera\" : \"machine_tags\" => \"*:title=\\\"mr. camera\\\"\"
    • \r\n\r\n
  • Find photos, in the 'dc' namespace whose value is \"mr. camera\" : \"machine_tags\" => \"dc:*=\\\"mr. camera\\\"\"
    • \r\n\r\n
\r\n\r\nMultiple machine tags may be queried by passing a comma-separated list. The number of machine tags you can pass in a single query depends on the tag mode (AND or OR) that you are querying with. \"AND\" queries are limited to (16) machine tags. \"OR\" queries are limited\r\nto (8)." + }, + { + "name": "machine_tag_mode", + "optional": "1", + "_content": "Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified." + }, + { + "name": "group_id", + "optional": "1", + "_content": "The id of a group who's pool to search. If specified, only matching photos posted to the group's pool will be returned." + }, + { + "name": "contacts", + "optional": "1", + "_content": "Search your contacts. Either 'all' or 'ff' for just friends and family. (Experimental)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A 32-bit identifier that uniquely represents spatial entities. (not used if bbox argument is present). \r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr place id. (not used if bbox argument is present).\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + }, + { + "name": "has_geo", + "optional": "1", + "_content": "Any photo that has been geotagged, or if the value is \"0\" any photo that has not been geotagged.\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "geo_context", + "optional": "1", + "_content": "Geo context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to search for photos that were taken \"indoors\" or \"outdoors\".

\r\nThe current list of context IDs is :

\r\n
    \r\n
  • 0, not defined.
    • \r\n
  • 1, indoors.
    • \r\n
  • 2, outdoors.
    • \r\n
\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "lat", + "optional": "1", + "_content": "A valid latitude, in decimal format, for doing radial geo queries.\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "lon", + "optional": "1", + "_content": "A valid longitude, in decimal format, for doing radial geo queries.\r\n

\r\nGeo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component.\r\n

\r\nA tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future)." + }, + { + "name": "radius", + "optional": "1", + "_content": "A valid radius used for geo queries, greater than zero and less than 20 miles (or 32 kilometers), for use with point-based geo queries. The default value is 5 (km)." + }, + { + "name": "radius_units", + "optional": "1", + "_content": "The unit of measure when doing radial geo queries. Valid options are \"mi\" (miles) and \"km\" (kilometers). The default is \"km\"." + }, + { + "name": "is_commons", + "optional": "1", + "_content": "Limit the scope of the search to only photos that are part of the Flickr Commons project. Default is false." + }, + { + "name": "in_gallery", + "optional": "1", + "_content": "Limit the scope of the search to only photos that are in a gallery? Default is false, search all photos." + }, + { + "name": "is_getty", + "optional": "1", + "_content": "Limit the scope of the search to only photos that are for sale on Getty. Default is false." + }, + { + "name": "extras", + "optional": 1, + "_content": "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" + }, + { + "name": "per_page", + "optional": 1, + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": 1, + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Too many tags in ALL query", + "_content": "When performing an 'all tags' search, you may not specify more than 20 tags to join together." + }, + { + "code": "2", + "message": "Unknown user", + "_content": "A user_id was passed which did not match a valid flickr user." + }, + { + "code": "3", + "message": "Parameterless searches have been disabled", + "_content": "To perform a search with no parameters (to get the latest public photos, please use flickr.photos.getRecent instead)." + }, + { + "code": "4", + "message": "You don't have permission to view this pool", + "_content": "The logged in user (if any) does not have permission to view the pool for this group." + }, + { + "code": "10", + "message": "Sorry, the Flickr search API is not currently available.", + "_content": "The Flickr API search databases are temporarily unavailable." + }, + { + "code": "11", + "message": "No valid machine tags", + "_content": "The query styntax for the machine_tags argument did not validate." + }, + { + "code": "12", + "message": "Exceeded maximum allowable machine tags", + "_content": "The maximum number of machine tags in a single query was exceeded." + }, + { + "code": "13", + "message": "jump_to not avaiable for this query", + "_content": "jump_to only supported for some query types." + }, + { + "code": "14", + "message": "Bad value for jump_to", + "_content": "jump_to must be valid photo ID." + }, + { + "code": "15", + "message": "Photo not found", + "_content": "" + }, + { + "code": "16", + "message": "You can only search within your own favorites", + "_content": "" + }, + { + "code": "17", + "message": "You can only search within your own contacts", + "_content": "The call tried to use the contacts parameter with no user ID or a user ID other than that of the authenticated user." + }, + { + "code": "18", + "message": "Illogical arguments", + "_content": "The request contained contradictory arguments." + }, + { + "code": "20", + "message": "Excessive photo offset in search", + "_content": "The search requested photos beyond an allowable offset. Reduce the page number or number of results per page for this search." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setContentType.json": { + "method": { + "name": "flickr.photos.setContentType", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the content type of a photo." + }, + "response": { + "_content": "\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set the adultness of." + }, + { + "name": "content_type", + "optional": "0", + "_content": "The content type of the photo. Must be one of: 1 for Photo, 2 for Screenshot, and 3 for Other." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id of a photo belonging to the calling user." + }, + { + "code": "2", + "message": "Required arguments missing", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": "3", + "message": "Change not allowed", + "_content": "Changing the content type of this photo is not allowed." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setDates.json": { + "method": { + "name": "flickr.photos.setDates", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set one or both of the dates for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to edit dates for." + }, + { + "name": "date_posted", + "optional": "1", + "_content": "The date the photo was uploaded to flickr (see the dates documentation)" + }, + { + "name": "date_taken", + "optional": "1", + "_content": "The date the photo was taken (see the dates documentation)" + }, + { + "name": "date_taken_granularity", + "optional": "1", + "_content": "The granularity of the date the photo was taken (see the dates documentation)" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was not the id of a valid photo belonging to the calling user." + }, + { + "code": "2", + "message": "Not enough arguments", + "_content": "No dates were specified to be changed." + }, + { + "code": "3", + "message": "Invalid granularity", + "_content": "The value passed for 'granularity' was not a valid flickr date granularity." + }, + { + "code": "4", + "message": "Invalid date_posted", + "_content": "The date posted is invalid, its in the past." + }, + { + "code": "5", + "message": "Invalid Date Taken Format", + "_content": "The date taken is not in the format that we support." + }, + { + "code": "6", + "message": "Invalid Date Taken", + "_content": "The date taken passed is invalid. It may be in the future or way in the past. " + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setMeta.json": { + "method": { + "name": "flickr.photos.setMeta", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the meta information for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set information for." + }, + { + "name": "title", + "optional": "1", + "_content": "The title for the photo. At least one of title or description must be set." + }, + { + "name": "description", + "optional": "1", + "_content": "The description for the photo. At least one of title or description must be set." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a photo belonging to the calling user. It might be an invalid id, or the photo might be owned by another user. " + }, + { + "code": "2", + "message": "At least one of title or description must be set", + "_content": "Since title and description is now optional, at least one of them must be sent. " + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setPerms.json": { + "method": { + "name": "flickr.photos.setPerms", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set permissions for a photo." + }, + "response": { + "_content": "1234" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set permissions for." + }, + { + "name": "is_public", + "optional": "0", + "_content": "1 to set the photo to public, 0 to set it to private." + }, + { + "name": "is_friend", + "optional": "0", + "_content": "1 to make the photo visible to friends when private, 0 to not." + }, + { + "name": "is_family", + "optional": "0", + "_content": "1 to make the photo visible to family when private, 0 to not." + }, + { + "name": "perm_comment", + "optional": "1", + "_content": "who can add comments to the photo and it's notes. one of:
\r\n0: nobody
\r\n1: friends & family
\r\n2: contacts
\r\n3: everybody" + }, + { + "name": "perm_addmeta", + "optional": "1", + "_content": "who can add notes and tags to the photo. one of:
\r\n0: nobody / just the owner
\r\n1: friends & family
\r\n2: contacts
\r\n3: everybody\r\n" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id of a photo belonging to the calling user." + }, + { + "code": "2", + "message": "Required arguments missing", + "_content": "Some or all of the required arguments were not supplied." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setSafetyLevel.json": { + "method": { + "name": "flickr.photos.setSafetyLevel", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the safety level of a photo." + }, + "response": { + "_content": "\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set the adultness of." + }, + { + "name": "safety_level", + "optional": "1", + "_content": "The safety level of the photo. Must be one of:\r\n\r\n1 for Safe, 2 for Moderate, and 3 for Restricted." + }, + { + "name": "hidden", + "optional": "1", + "_content": "Whether or not to additionally hide the photo from public searches. Must be either 1 for Yes or 0 for No." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id of a photo belonging to the calling user." + }, + { + "code": "2", + "message": "Invalid or missing arguments", + "_content": "Neither a valid safety level nor a hidden value were passed." + }, + { + "code": "3", + "message": "Change not allowed", + "_content": "Changing the safety level of this photo is not allowed." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.setTags.json": { + "method": { + "name": "flickr.photos.setTags", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the tags for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set tags for.\r\n" + }, + { + "name": "tags", + "optional": "0", + "_content": "All tags for the photo (as a single space-delimited string)." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a photo belonging to the calling user. It might be an invalid id, or the photo might be owned by another user. " + }, + { + "code": "2", + "message": "Maximum number of tags reached", + "_content": "The number of tags specified exceeds the limit for the photo. No tags were modified." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.suggestions.approveSuggestion.json": { + "method": { + "name": "flickr.photos.suggestions.approveSuggestion", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Approve a suggestion for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "suggestion_id", + "optional": "0", + "_content": "The unique ID for the location suggestion to approve." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.suggestions.getList.json": { + "method": { + "name": "flickr.photos.suggestions.getList", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return a list of suggestions for a user that are pending approval." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "1", + "_content": "Only show suggestions for a single photo." + }, + { + "name": "status_id", + "optional": "1", + "_content": "Only show suggestions with a given status.\r\n\r\n
    \r\n
  • 0, pending
    • \r\n
  • 1, approved
    • \r\n
  • 2, rejected
    • \r\n
\r\n\r\nThe default is pending (or \"0\")." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.suggestions.rejectSuggestion.json": { + "method": { + "name": "flickr.photos.suggestions.rejectSuggestion", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Reject a suggestion for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "suggestion_id", + "optional": "0", + "_content": "The unique ID of the suggestion to reject." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.suggestions.removeSuggestion.json": { + "method": { + "name": "flickr.photos.suggestions.removeSuggestion", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove a suggestion, made by the calling user, from a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "suggestion_id", + "optional": "0", + "_content": "The unique ID for the location suggestion to approve." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.suggestions.suggestLocation.json": { + "method": { + "name": "flickr.photos.suggestions.suggestLocation", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Suggest a geotagged location for a photo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The photo whose location you are suggesting." + }, + { + "name": "lat", + "optional": "0", + "_content": "The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated." + }, + { + "name": "lon", + "optional": "0", + "_content": "The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. Defaults to 16 if not specified." + }, + { + "name": "woe_id", + "optional": "1", + "_content": "The WOE ID of the location used to build the location hierarchy for the photo." + }, + { + "name": "place_id", + "optional": "1", + "_content": "The Flickr Places ID of the location used to build the location hierarchy for the photo." + }, + { + "name": "note", + "optional": "1", + "_content": "A short note or history to include with the suggestion." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.transform.rotate.json": { + "method": { + "name": "flickr.photos.transform.rotate", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Rotate a photo." + }, + "response": { + "_content": "1234" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to rotate." + }, + { + "name": "degrees", + "optional": "0", + "_content": "The amount of degrees by which to rotate the photo (clockwise) from it's current orientation. Valid values are 90, 180 and 270." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id was invalid or did not belong to the calling user." + }, + { + "code": "2", + "message": "Invalid rotation", + "_content": "The rotation degrees were an invalid value." + }, + { + "code": "3", + "message": "Temporary failure", + "_content": "There was a problem either rotating the image or storing the rotated versions." + }, + { + "code": "4", + "message": "Rotation disabled", + "_content": "The rotation service is currently disabled." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photos.upload.checkTickets.json": { + "method": { + "name": "flickr.photos.upload.checkTickets", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Checks the status of one or more asynchronous photo upload tickets." + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <ticket> element for each ticket id supplied. The id attribute contains the corresponding ticket id. If the ticket wasn't found, the invalid attribute is set. The status of the ticket is passed in the status attribute; 0 means not completed, 1 means completed and 2 means the ticket failed (indicating there was a problem converting the file). When the status is 1, the photo id is passed in the photoid attribute. The photo id can then be used as with the synchronous upload API." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tickets", + "optional": "0", + "_content": "A comma-delimited list of ticket ids" + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.addPhoto.json": { + "method": { + "name": "flickr.photosets.addPhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a photo to the end of an existing photoset." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to add a photo to." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to add to the set." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not the id of avalid photoset owned by the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a valid photo owned by the calling user." + }, + { + "code": "3", + "message": "Photo already in set", + "_content": "The photo is already a member of the photoset." + }, + { + "code": "10", + "message": "Maximum number of photos in set", + "_content": "A set has reached the upper limit for the number of photos allowed." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.comments.addComment.json": { + "method": { + "name": "flickr.photosets.comments.addComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Add a comment to a photoset." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to add a comment to." + }, + { + "name": "comment_text", + "optional": "0", + "_content": "Text of the comment" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "" + }, + { + "code": "8", + "message": "Blank comment", + "_content": "" + }, + { + "code": "9", + "message": "User is posting comments too fast.", + "_content": "The user has reached the limit for number of comments posted during a specific time period. Wait a bit and try again." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.comments.deleteComment.json": { + "method": { + "name": "flickr.photosets.comments.deleteComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Delete a photoset comment as the currently authenticated user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "comment_id", + "optional": "0", + "_content": "The id of the comment to delete from a photoset." + } + ] + }, + "errors": { + "error": [ + { + "code": "2", + "message": "Comment not found.", + "_content": "The comment id passed was not a valid comment id" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.comments.editComment.json": { + "method": { + "name": "flickr.photosets.comments.editComment", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Edit the text of a comment as the currently authenticated user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "comment_id", + "optional": "0", + "_content": "The id of the comment to edit." + }, + { + "name": "comment_text", + "optional": "0", + "_content": "Update the comment to this text." + } + ] + }, + "errors": { + "error": [ + { + "code": "2", + "message": "Comment not found.", + "_content": "The comment id passed was not a valid comment id." + }, + { + "code": "8", + "message": "Blank comment.", + "_content": "Comment text can't be blank." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.comments.getList.json": { + "method": { + "name": "flickr.photosets.comments.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the comments for a photoset." + }, + "response": { + "_content": "\r\n Umm, I'm not sure, can I get back to you on that one?\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to fetch comments for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found.", + "_content": "The photoset id was invalid." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.create.json": { + "method": { + "name": "flickr.photosets.create", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Create a new photoset for the calling user." + }, + "response": { + "_content": "" + }, + "explanation": { + "_content": "

New photosets are automatically put first in the photoset ordering for the user. Use flickr.photosets.orderSets if you don't want the new set to appear first on the user's photoset list.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "title", + "optional": "0", + "_content": "A title for the photoset." + }, + { + "name": "description", + "optional": "1", + "_content": "A description of the photoset. May contain limited html." + }, + { + "name": "primary_photo_id", + "optional": "0", + "_content": "The id of the photo to represent this set. The photo must belong to the calling user." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "No title specified", + "_content": "No title parameter was passed in the request." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The primary photo id passed was not a valid photo id or does not belong to the calling user." + }, + { + "code": "3", + "message": "Can't create any more sets", + "_content": "The user has reached their maximum number of photosets limit." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.delete.json": { + "method": { + "name": "flickr.photosets.delete", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Delete a photoset." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to delete. It must be owned by the calling user." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not a valid photoset id or did not belong to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.editMeta.json": { + "method": { + "name": "flickr.photosets.editMeta", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Modify the meta-data for a photoset." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to modify." + }, + { + "name": "title", + "optional": "0", + "_content": "The new title for the photoset." + }, + { + "name": "description", + "optional": "1", + "_content": "A description of the photoset. May contain limited html." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not a valid photoset id or did not belong to the calling user." + }, + { + "code": "2", + "message": "No title specified", + "_content": "No title parameter was passed in the request. " + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.editPhotos.json": { + "method": { + "name": "flickr.photosets.editPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Modify the photos in a photoset. Use this method to add, remove and re-order photos." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to modify. The photoset must belong to the calling user." + }, + { + "name": "primary_photo_id", + "optional": "0", + "_content": "The id of the photo to use as the 'primary' photo for the set. This id must also be passed along in photo_ids list argument." + }, + { + "name": "photo_ids", + "optional": "0", + "_content": "A comma-delimited list of photo ids to include in the set. They will appear in the set in the order sent. This list must contain the primary photo id. All photos must belong to the owner of the set. This list of photos replaces the existing list. Call flickr.photosets.addPhoto to append a photo to a set." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not a valid photoset id or did not belong to the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "One or more of the photo ids passed was not a valid photo id or does not belong to the calling user." + }, + { + "code": "3", + "message": "Primary photo not found", + "_content": "The primary photo id passed was not a valid photo id or does not belong to the calling user." + }, + { + "code": "4", + "message": "Primary photo not in list", + "_content": "The primary photo id passed did not appear in the photo id list." + }, + { + "code": "5", + "message": "Empty photos list", + "_content": "No photo ids were passed." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.getContext.json": { + "method": { + "name": "flickr.photosets.getContext", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns next and previous photos for a photo in a set." + }, + "response": { + "_content": " \r\n " + }, + "explanation": { + "_content": "

See flickr.photos.getContext

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to fetch the context for." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset for which to fetch the photo's context." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id, or was the id of a photo that the calling user does not have permission to view." + }, + { + "code": "2", + "message": "Photo not in set", + "_content": "The specified photo is not in the specified set." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.getInfo.json": { + "method": { + "name": "flickr.photosets.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Gets information about a photoset." + }, + "response": { + "_content": "\r\n Mah Kittehs\r\n Sixty and Niner. Born on the 3rd of May, 2010, or thereabouts. Came to my place on Thursday, July 29, 2010.\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The ID of the photoset to fetch information for." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The user_id here is the owner of the set passed in photoset_id. This is optional, but passing this gives better performance. " + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id was not valid." + }, + { + "code": "2", + "message": "User not found", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.getList.json": { + "method": { + "name": "flickr.photosets.getList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the photosets belonging to the specified user." + }, + "response": { + "_content": "\r\n \r\n Avis Blanche\r\n My Grandma's Recipe File.\r\n \r\n \r\n Mah Kittehs\r\n Sixty and Niner. Born on the 3rd of May, 2010, or thereabouts. Came to my place on Thursday, July 29, 2010.\r\n \r\n" + }, + "explanation": { + "_content": "

Photosets are returned in the user's specified order, which may not mean the newest set is first. Applications displaying photosets should respect the user's ordering.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user to get a photoset list for. If none is specified, the calling user is assumed." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to get. Currently, if this is not provided, all sets are returned, but this behaviour may change in future." + }, + { + "name": "per_page", + "optional": "1", + "_content": "The number of sets to get per page. If paging is enabled, the maximum number of sets per page is 500." + }, + { + "name": "primary_photo_extras", + "optional": "1", + "_content": "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" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user NSID passed was not a valid user NSID and the calling user was not logged in.\r\n" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.getPhotos.json": { + "method": { + "name": "flickr.photosets.getPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the list of photos in a set." + }, + "response": { + "_content": "\r\n\t \r\n\t \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to return the photos for." + }, + { + "name": "user_id", + "optional": "0", + "_content": "The user_id here is the owner of the set passed in photoset_id. This is optional, but passing this gives better performance. " + }, + { + "name": "extras", + "optional": "1", + "_content": "A comma-delimited list of extra information to fetch for each returned record. 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" + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of photos to return per page. If this argument is omitted, it defaults to 500. The maximum allowed value is 500." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + }, + { + "name": "privacy_filter", + "optional": "1", + "_content": "Return photos only matching a certain privacy level. This only applies when making an authenticated call to view a photoset you own. Valid values are:\r\n
    \r\n
  • 1 public photos
    • \r\n
  • 2 private photos visible to friends
    • \r\n
  • 3 private photos visible to family
    • \r\n
  • 4 private photos visible to friends & family
    • \r\n
  • 5 completely private photos
    • \r\n
\r\n" + }, + { + "name": "media", + "optional": "1", + "_content": "Filter results by media type. Possible values are all (default), photos or videos" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not a valid photoset id." + }, + { + "code": "2", + "message": "User not found", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.orderSets.json": { + "method": { + "name": "flickr.photosets.orderSets", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set the order of photosets for the calling user." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_ids", + "optional": "0", + "_content": "A comma delimited list of photoset IDs, ordered with the set to show first, first in the list. Any set IDs not given in the list will be set to appear at the end of the list, ordered by their IDs." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Set not found", + "_content": "One of the photoset ids passed was not the id of a valid photoset belonging to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.removePhoto.json": { + "method": { + "name": "flickr.photosets.removePhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove a photo from a photoset." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to remove a photo from." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to remove from the set." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not the id of avalid photoset owned by the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a valid photo belonging to the calling user." + }, + { + "code": "3", + "message": "Photo not in set", + "_content": "The photo is not a member of the photoset." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.removePhotos.json": { + "method": { + "name": "flickr.photosets.removePhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Remove multiple photos from a photoset." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to remove photos from." + }, + { + "name": "photo_ids", + "optional": "0", + "_content": "Comma-delimited list of photo ids to remove from the photoset." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not the id of available photosets owned by the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a valid photo belonging to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.reorderPhotos.json": { + "method": { + "name": "flickr.photosets.reorderPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to reorder. The photoset must belong to the calling user." + }, + { + "name": "photo_ids", + "optional": "0", + "_content": "Ordered, comma-delimited list of photo ids. Photos that are not in the list will keep their original order" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not a valid photoset id or did not belong to the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "One or more of the photo ids passed was not a valid photo id or does not belong to the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.photosets.setPrimaryPhoto.json": { + "method": { + "name": "flickr.photosets.setPrimaryPhoto", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "2", + "description": { + "_content": "Set photoset primary photo" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to set primary photo to." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to set as primary." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photoset not found", + "_content": "The photoset id passed was not the id of avalid photoset owned by the calling user." + }, + { + "code": "2", + "message": "Photo not found", + "_content": "The photo id passed was not the id of a valid photo owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.find.json": { + "method": { + "name": "flickr.places.find", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of place IDs for a query string.

\r\nThe flickr.places.find method is not a geocoder. It will round up to the nearest place type to which place IDs apply. For example, if you pass it a street level address it will return the city that contains the address rather than the street, or building, itself." + }, + "response": { + "_content": "\r\n Alabama, Alabama, United States\r\n Alabama, New York, United States\r\n Alabama, North West, South Africa\r\n" + }, + "explanation": { + "_content": "Each place returned will contain its place ID, corresponding URL (underneath www.flickr.com/places) and place type for disambiguating different locations with the same name." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "query", + "optional": "0", + "_content": "The query string to use for place ID lookups" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameters was not included with the API call." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.findByLatLon.json": { + "method": { + "name": "flickr.places.findByLatLon", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a place ID for a latitude, longitude and accuracy triple.

\r\nThe flickr.places.findByLatLon method is not meant to be a (reverse) geocoder in the traditional sense. It is designed to allow users to find photos for \"places\" and will round up to the nearest place type to which corresponding place IDs apply.

\r\nFor example, if you pass it a street level coordinate it will return the city that contains the point rather than the street, or building, itself.

\r\nIt will also truncate latitudes and longitudes to three decimal points.\r\n\r\n" + }, + "response": { + "_content": "\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "lat", + "optional": "0", + "_content": "The latitude whose valid range is -90 to 90. Anything more than 4 decimal places will be truncated." + }, + { + "name": "lon", + "optional": "0", + "_content": "The longitude whose valid range is -180 to 180. Anything more than 4 decimal places will be truncated." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Recorded accuracy level of the location information. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. The default is 16." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required arguments missing", + "_content": "One or more required parameters was not included with the API request." + }, + { + "code": "2", + "message": "Not a valid latitude", + "_content": "The latitude argument failed validation." + }, + { + "code": "3", + "message": "Not a valid longitude", + "_content": "The longitude argument failed validation." + }, + { + "code": "4", + "message": "Not a valid accuracy", + "_content": "The accuracy argument failed validation." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getChildrenWithPhotosPublic.json": { + "method": { + "name": "flickr.places.getChildrenWithPhotosPublic", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of locations with public photos that are parented by a Where on Earth (WOE) or Places ID." + }, + "response": { + "_content": "\r\n \r\n Montreal Golden Square Mile, Montreal, QC, CA, Canada\r\n \r\n \r\n Downtown Montréal, Montreal, QC, CA, Canada\r\n \r\n\r\n \r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameter is missing from the API call." + }, + { + "code": "2", + "message": "Not a valid Places ID", + "_content": "An invalid Places (or WOE) ID was passed with the API call." + }, + { + "code": "3", + "message": "Place not found", + "_content": "No place could be found for the Places (or WOE) ID passed to the API call." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getInfo.json": { + "method": { + "name": "flickr.places.getInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get informations about a place." + }, + "response": { + "_content": "\r\n Montreal\r\n Montréal\r\n Quebec\r\n Canada\r\n \r\n \r\n \r\n 45.427627563477,-73.589645385742 45.428966522217,-73.587898254395, etc...\r\n \r\n \r\n \r\n \r\n http://farm4.static.flickr.com/3228/shapefiles/3534_20081111_0a8afe03c5.tar.gz\r\n \r\n \r\n \r\n" + }, + "explanation": { + "_content": " " + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameter is missing from the API call." + }, + { + "code": "2", + "message": "Not a valid Places ID", + "_content": "An invalid Places (or WOE) ID was passed with the API call." + }, + { + "code": "3", + "message": "Place not found", + "_content": "No place could be found for the Places (or WOE) ID passed to the API call." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getInfoByUrl.json": { + "method": { + "name": "flickr.places.getInfoByUrl", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Lookup information about a place, by its flickr.com/places URL." + }, + "response": { + "_content": "\r\n Montreal\r\n Montréal\r\n Quebec\r\n Canada\r\n \r\n \r\n \r\n 45.427627563477,-73.589645385742 45.428966522217,-73.587898254395, etc...\r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "url", + "optional": "0", + "_content": "A flickr.com/places URL in the form of /country/region/city. For example: /Canada/Quebec/Montreal" + } + ] + }, + "errors": { + "error": [ + { + "code": "2", + "message": "Place URL required.", + "_content": "The flickr.com/places URL was not passed with the API method." + }, + { + "code": "3", + "message": "Place not found.", + "_content": "Unable to find a valid place for the places URL." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getPlaceTypes.json": { + "method": { + "name": "flickr.places.getPlaceTypes", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Fetches a list of available place types for Flickr." + }, + "response": { + "_content": "\r\n neighbourhood\r\n locality\r\n county\r\n region\r\n country\r\n continent\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getShapeHistory.json": { + "method": { + "name": "flickr.places.getShapeHistory", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return an historical list of all the shape data generated for a Places or Where on Earth (WOE) ID." + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n 45.427627563477,-73.589645385742 45.428966522217,-73.587898254395, etc...\r\n \r\n \r\n \r\n \r\n http://farm4.static.flickr.com/3228/shapefiles/3534_20081111_0a8afe03c5.tar.gz\r\n \r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameter is missing from the API call." + }, + { + "code": "2", + "message": "Not a valid Places ID", + "_content": "An invalid Places (or WOE) ID was passed with the API call." + }, + { + "code": "3", + "message": "Place not found", + "_content": "No place could be found for the Places (or WOE) ID passed to the API call." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.getTopPlacesList.json": { + "method": { + "name": "flickr.places.getTopPlacesList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return the top 100 most geotagged places for a day." + }, + "response": { + "_content": "\r\n United States\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_type_id", + "optional": "0", + "_content": "The numeric ID for a specific place type to cluster photos by.

\r\n\r\nValid place type IDs are :\r\n\r\n
    \r\n
  • 22: neighbourhood
    • \r\n
  • 7: locality
    • \r\n
  • 8: region
    • \r\n
  • 12: country
    • \r\n
  • 29: continent
    • \r\n
" + }, + { + "name": "date", + "optional": "1", + "_content": "A valid date in YYYY-MM-DD format. The default is yesterday." + }, + { + "name": "woe_id", + "optional": "1", + "_content": "Limit your query to only those top places belonging to a specific Where on Earth (WOE) identifier." + }, + { + "name": "place_id", + "optional": "1", + "_content": "Limit your query to only those top places belonging to a specific Flickr Places identifier." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more required parameters with missing from your request." + }, + { + "code": "2", + "message": "Not a valid place type.", + "_content": "An unknown or unsupported place type ID was passed with your request." + }, + { + "code": "3", + "message": "Not a valid date.", + "_content": "The date argument passed with your request is invalid." + }, + { + "code": "4", + "message": "Not a valid Place ID", + "_content": "An invalid Places (or WOE) identifier was included with your request." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.placesForBoundingBox.json": { + "method": { + "name": "flickr.places.placesForBoundingBox", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return all the locations of a matching place type for a bounding box.

\r\n\r\nThe maximum allowable size of a bounding box (the distance between the SW and NE corners) is governed by the place type you are requesting. Allowable sizes are as follows:\r\n\r\n
    \r\n
  • neighbourhood: 3km (1.8mi)
    • \r\n
  • locality: 7km (4.3mi)
    • \r\n
  • county: 50km (31mi)
    • \r\n
  • region: 200km (124mi)
    • \r\n
  • country: 500km (310mi)
    • \r\n
  • continent: 1500km (932mi)
    • \r\n
" + }, + "response": { + "_content": "\r\n \r\n Downtown, San Francisco, CA, US, United States\r\n \r\n \r\n Civic Center, San Francisco, CA, US, United States\r\n \r\n \r\n Chinatown, San Francisco, CA, US, United States\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "bbox", + "optional": "0", + "_content": "A comma-delimited list of 4 values defining the Bounding Box of the area that will be searched. The 4 values represent the bottom-left corner of the box and the top-right corner, minimum_longitude, minimum_latitude, maximum_longitude, maximum_latitude." + }, + { + "name": "place_type", + "optional": "1", + "_content": "The name of place type to using as the starting point to search for places in a bounding box. Valid placetypes are:\r\n\r\n
    \r\n
  • neighbourhood
    • \r\n
  • locality
    • \r\n
  • county
    • \r\n
  • region
    • \r\n
  • country
    • \r\n
  • continent
    • \r\n
\r\n
\r\nThe \"place_type\" argument has been deprecated in favor of the \"place_type_id\" argument. It won't go away but it will not be added to new methods. A complete list of place type IDs is available using the flickr.places.getPlaceTypes method. (While optional, you must pass either a valid place type or place type ID.)" + }, + { + "name": "place_type_id", + "optional": "1", + "_content": "The numeric ID for a specific place type to cluster photos by.

\r\n\r\nValid place type IDs are :\r\n\r\n
    \r\n
  • 22: neighbourhood
    • \r\n
  • 7: locality
    • \r\n
  • 8: region
    • \r\n
  • 12: country
    • \r\n
  • 29: continent
    • \r\n
\r\n
(While optional, you must pass either a valid place type or place type ID.)\r\n" + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameters missing", + "_content": "One or more required parameter is missing from the API call." + }, + { + "code": "2", + "message": "Not a valid bbox", + "_content": "The bbox argument was incomplete or incorrectly formatted" + }, + { + "code": "3", + "message": "Not a valid place type", + "_content": "An invalid place type was included with your request." + }, + { + "code": "4", + "message": "Bounding box exceeds maximum allowable size for place type", + "_content": "The bounding box passed along with your request was too large for the request place type." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.placesForContacts.json": { + "method": { + "name": "flickr.places.placesForContacts", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return a list of the top 100 unique places clustered by a given placetype for a user's contacts. " + }, + "response": { + "_content": "\r\n San Francisco, California\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_type", + "optional": "1", + "_content": "A specific place type to cluster photos by.

\r\n\r\nValid place types are :\r\n\r\n
    \r\n
  • neighbourhood (and neighborhood)
    • \r\n
  • locality
    • \r\n
  • region
    • \r\n
  • country
    • \r\n
  • continent
    • \r\n
\r\n
\r\nThe \"place_type\" argument has been deprecated in favor of the \"place_type_id\" argument. It won't go away but it will not be added to new methods. A complete list of place type IDs is available using the flickr.places.getPlaceTypes method. (While optional, you must pass either a valid place type or place type ID.)" + }, + { + "name": "place_type_id", + "optional": "1", + "_content": "The numeric ID for a specific place type to cluster photos by.

\r\n\r\nValid place type IDs are :\r\n\r\n
    \r\n
  • 22: neighbourhood
    • \r\n
  • 7: locality
    • \r\n
  • 8: region
    • \r\n
  • 12: country
    • \r\n
  • 29: continent
    • \r\n
\r\n
(While optional, you must pass either a valid place type or place type ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where on Earth identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (WOE ID 23424977).

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (Place ID 4KO02SibApitvSBieQ).\r\n

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "threshold", + "optional": "1", + "_content": "The minimum number of photos that a place type must have to be included. If the number of photos is lowered then the parent place type for that place will be used.

\r\n\r\nFor example if your contacts only have 3 photos taken in the locality of Montreal (WOE ID 3534) but your threshold is set to 5 then those photos will be \"rolled up\" and included instead with a place record for the region of Quebec (WOE ID 2344924)." + }, + { + "name": "contacts", + "optional": "1", + "_content": "Search your contacts. Either 'all' or 'ff' for just friends and family. (Default is all)" + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Places for contacts are not available at this time", + "_content": "Places for contacts have been disabled or are otherwise not available." + }, + { + "code": "2", + "message": "Required parameter missing", + "_content": "One or more of the required parameters was not included with your request." + }, + { + "code": "3", + "message": "Not a valid place type.", + "_content": "An invalid place type was included with your request." + }, + { + "code": "4", + "message": "Not a valid Place ID", + "_content": "An invalid Places (or WOE) identifier was included with your request." + }, + { + "code": "5", + "message": "Not a valid threshold", + "_content": "The threshold passed was invalid. " + }, + { + "code": "6", + "message": "Not a valid contacts type", + "_content": "Contacts must be either \"all\" or \"ff\" (friends and family)." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.placesForTags.json": { + "method": { + "name": "flickr.places.placesForTags", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of the top 100 unique places clustered by a given placetype for set of tags or machine tags. " + }, + "response": { + "_content": "\r\n San Francisco, California\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_type_id", + "optional": "0", + "_content": "The numeric ID for a specific place type to cluster photos by.

\r\n\r\nValid place type IDs are :\r\n\r\n
    \r\n
  • 22: neighbourhood
    • \r\n
  • 7: locality
    • \r\n
  • 8: region
    • \r\n
  • 12: country
    • \r\n
  • 29: continent
    • \r\n
" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where on Earth identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (WOE ID 23424977).\r\n

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (Place ID 4KO02SibApitvSBieQ).\r\n

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "threshold", + "optional": "1", + "_content": "The minimum number of photos that a place type must have to be included. If the number of photos is lowered then the parent place type for that place will be used.

\r\n\r\nFor example if you only have 3 photos taken in the locality of Montreal (WOE ID 3534) but your threshold is set to 5 then those photos will be \"rolled up\" and included instead with a place record for the region of Quebec (WOE ID 2344924)." + }, + { + "name": "tags", + "optional": "1", + "_content": "A comma-delimited list of tags. Photos with one or more of the tags listed will be returned.\r\n

\r\n(While optional, you must pass either a valid tag or machine_tag" + }, + { + "name": "tag_mode", + "optional": "1", + "_content": "Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified." + }, + { + "name": "machine_tags", + "optional": "1", + "_content": "Aside from passing in a fully formed machine tag, there is a special syntax for searching on specific properties :\r\n\r\n
    \r\n
  • Find photos using the 'dc' namespace : \"machine_tags\" => \"dc:\"
    • \r\n\r\n
  • Find photos with a title in the 'dc' namespace : \"machine_tags\" => \"dc:title=\"
    • \r\n\r\n
  • Find photos titled \"mr. camera\" in the 'dc' namespace : \"machine_tags\" => \"dc:title=\\\"mr. camera\\\"
    • \r\n\r\n
  • Find photos whose value is \"mr. camera\" : \"machine_tags\" => \"*:*=\\\"mr. camera\\\"\"
    • \r\n\r\n
  • Find photos that have a title, in any namespace : \"machine_tags\" => \"*:title=\"
    • \r\n\r\n
  • Find photos that have a title, in any namespace, whose value is \"mr. camera\" : \"machine_tags\" => \"*:title=\\\"mr. camera\\\"\"
    • \r\n\r\n
  • Find photos, in the 'dc' namespace whose value is \"mr. camera\" : \"machine_tags\" => \"dc:*=\\\"mr. camera\\\"\"
    • \r\n\r\n
\r\n\r\nMultiple machine tags may be queried by passing a comma-separated list. The number of machine tags you can pass in a single query depends on the tag mode (AND or OR) that you are querying with. \"AND\" queries are limited to (16) machine tags. \"OR\" queries are limited\r\nto (8).\r\n

\r\n(While optional, you must pass either a valid tag or machine_tag)" + }, + { + "name": "machine_tag_mode", + "optional": "1", + "_content": "Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified." + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.placesForUser.json": { + "method": { + "name": "flickr.places.placesForUser", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Return a list of the top 100 unique places clustered by a given placetype for a user. " + }, + "response": { + "_content": "\r\n San Francisco, California\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_type_id", + "optional": "1", + "_content": "The numeric ID for a specific place type to cluster photos by.

\r\n\r\nValid place type IDs are :\r\n\r\n
    \r\n
  • 22: neighbourhood
    • \r\n
  • 7: locality
    • \r\n
  • 8: region
    • \r\n
  • 12: country
    • \r\n
  • 29: continent
    • \r\n
\r\n
\r\nThe \"place_type\" argument has been deprecated in favor of the \"place_type_id\" argument. It won't go away but it will not be added to new methods. A complete list of place type IDs is available using the flickr.places.getPlaceTypes method. (While optional, you must pass either a valid place type or place type ID.)" + }, + { + "name": "place_type", + "optional": "1", + "_content": "A specific place type to cluster photos by.

\r\n\r\nValid place types are :\r\n\r\n
    \r\n
  • neighbourhood (and neighborhood)
    • \r\n
  • locality
    • \r\n
  • region
    • \r\n
  • country
    • \r\n
  • continent
    • \r\n
\r\n
(While optional, you must pass either a valid place type or place type ID.)" + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where on Earth identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (WOE ID 23424977).

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places identifier to use to filter photo clusters. For example all the photos clustered by locality in the United States (Place ID 4KO02SibApitvSBieQ).

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "threshold", + "optional": "1", + "_content": "The minimum number of photos that a place type must have to be included. If the number of photos is lowered then the parent place type for that place will be used.

\r\n\r\nFor example if you only have 3 photos taken in the locality of Montreal (WOE ID 3534) but your threshold is set to 5 then those photos will be \"rolled up\" and included instead with a place record for the region of Quebec (WOE ID 2344924)." + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Places for user are not available at this time", + "_content": "Places for user have been disabled or are otherwise not available." + }, + { + "code": "2", + "message": "Required parameter missing", + "_content": "One or more of the required parameters was not included with your request." + }, + { + "code": "3", + "message": "Not a valid place type", + "_content": "An invalid place type was included with your request." + }, + { + "code": "4", + "message": "Not a valid Place ID", + "_content": "An invalid Places (or WOE) identifier was included with your request." + }, + { + "code": "5", + "message": "Not a valid threshold", + "_content": "The threshold passed was invalid. " + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.resolvePlaceId.json": { + "method": { + "name": "flickr.places.resolvePlaceId", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Find Flickr Places information by Place ID.

\r\nThis method has been deprecated. It won't be removed but you should use flickr.places.getInfo instead." + }, + "response": { + "_content": "\r\n San Francisco\r\n San Francisco\r\n California\r\n United States\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "place_id", + "optional": "0", + "_content": "A Flickr Places ID" + } + ] + }, + "errors": { + "error": [ + { + "code": "2", + "message": "Place ID required.", + "_content": "" + }, + { + "code": "3", + "message": "Place not found.", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.resolvePlaceURL.json": { + "method": { + "name": "flickr.places.resolvePlaceURL", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Find Flickr Places information by Place URL.

\r\nThis method has been deprecated. It won't be removed but you should use flickr.places.getInfoByUrl instead.\r\n" + }, + "response": { + "_content": "\r\n San Francisco\r\n San Francisco\r\n California\r\n United States\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "url", + "optional": "0", + "_content": "A Flickr Places URL. \r\n

\r\nFlickr Place URLs are of the form /country/region/city" + } + ] + }, + "errors": { + "error": [ + { + "code": "2", + "message": "Place URL required.", + "_content": "" + }, + { + "code": "3", + "message": "Place not found.", + "_content": "" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.places.tagsForPlace.json": { + "method": { + "name": "flickr.places.tagsForPlace", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Return a list of the top 100 unique tags for a Flickr Places or Where on Earth (WOE) ID" + }, + "response": { + "_content": "\r\n montreal\r\n canada\r\n montréal\r\n quebec\r\n québec\r\n sylvainmichaud\r\n nikon\r\n lucbus\r\n music\r\n urban\r\n lucbussieres\r\n festival\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "woe_id", + "optional": "1", + "_content": "A Where on Earth identifier to use to filter photo clusters.

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "place_id", + "optional": "1", + "_content": "A Flickr Places identifier to use to filter photo clusters.

\r\n(While optional, you must pass either a valid Places ID or a WOE ID.)" + }, + { + "name": "min_upload_date", + "optional": "1", + "_content": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "max_upload_date", + "optional": "1", + "_content": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date should be in the form of a unix timestamp." + }, + { + "name": "min_taken_date", + "optional": "1", + "_content": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date should be in the form of a mysql datetime." + }, + { + "name": "max_taken_date", + "optional": "1", + "_content": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date should be in the form of a mysql datetime." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One or more parameters was not included with the API request" + }, + { + "code": "2", + "message": "Not a valid Places ID", + "_content": "An invalid Places (or WOE) identifier was included with your request." + }, + { + "code": "3", + "message": "Place not found", + "_content": "An invalid Places (or WOE) identifier was included with your request." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.prefs.getContentType.json": { + "method": { + "name": "flickr.prefs.getContentType", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the default content type preference for the user." + }, + "response": { + "_content": "\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.prefs.getGeoPerms.json": { + "method": { + "name": "flickr.prefs.getGeoPerms", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the default privacy level for geographic information attached to the user's photos and whether or not the user has chosen to use geo-related EXIF information to automatically geotag their photos.\r\n\r\nPossible values, for viewing geotagged photos, are:\r\n\r\n
    \r\n
  • 0 : No default set
    • \r\n
  • 1 : Public
    • \r\n
  • 2 : Contacts only
    • \r\n
  • 3 : Friends and Family only
    • \r\n
  • 4 : Friends only
    • \r\n
  • 5 : Family only
    • \r\n
  • 6 : Private
    • \r\n
\r\n\r\nUsers can edit this preference at http://www.flickr.com/account/geo/privacy/.\r\n

\r\nPossible values for whether or not geo-related EXIF information will be used to geotag a photo are:\r\n\r\n
    \r\n
  • 0: Geo-related EXIF information will be ignored
    • \r\n
  • 1: Geo-related EXIF information will be used to try and geotag photos on upload
    • \r\n
\r\n\r\nUsers can edit this preference at http://www.flickr.com/account/geo/exif/?from=privacy" + }, + "response": { + "_content": "\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.prefs.getHidden.json": { + "method": { + "name": "flickr.prefs.getHidden", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the default hidden preference for the user." + }, + "response": { + "_content": "\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.prefs.getPrivacy.json": { + "method": { + "name": "flickr.prefs.getPrivacy", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the default privacy level preference for the user.\r\n\r\nPossible values are:\r\n
    \r\n
  • 1 : Public
    • \r\n
  • 2 : Friends only
    • \r\n
  • 3 : Family only
    • \r\n
  • 4 : Friends and Family
    • \r\n
  • 5 : Private
    • \r\n
" + }, + "response": { + "_content": "\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.prefs.getSafetyLevel.json": { + "method": { + "name": "flickr.prefs.getSafetyLevel", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns the default safety level preference for the user." + }, + "response": { + "_content": "\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.push.getSubscriptions.json": { + "method": { + "name": "flickr.push.getSubscriptions", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of the subscriptions for the logged-in user.\r\n

\r\n(this method is experimental and may change)" + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": "5", + "message": "Service currently available only to pro accounts", + "_content": "PuSH subscriptions are currently restricted to Pro account holders." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.push.getTopics.json": { + "method": { + "name": "flickr.push.getTopics", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "All the different flavours of anteater.\r\n

\r\n(this method is experimental and may change)" + }, + "response": { + "_content": "\r\n \r\n \r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.push.subscribe.json": { + "method": { + "name": "flickr.push.subscribe", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "In ur pandas, tickling ur unicorn\r\n

\r\n(this method is experimental and may change)" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "topic", + "optional": "0", + "_content": "The type of subscription. See flickr.push.getTopics." + }, + { + "name": "callback", + "optional": "0", + "_content": "The url for the subscription endpoint. Limited to 255 bytes, and must be unique for this user, i.e. no two subscriptions for a given user may use the same callback url." + }, + { + "name": "verify", + "optional": "0", + "_content": "The verification mode, either sync or async. See the Google PubSubHubbub spec for details." + }, + { + "name": "verify_token", + "optional": "1", + "_content": "The verification token to be echoed back to the subscriber during the verification callback, as per the Google PubSubHubbub spec. Limited to 200 bytes." + }, + { + "name": "lease_seconds", + "optional": "1", + "_content": "Number of seconds for which the subscription will be valid. Legal values are 60 to 86400 (1 minute to 1 day). If not present, the subscription will be auto-renewing." + }, + { + "name": "woe_ids", + "optional": "1", + "_content": "A 32-bit integer for a Where on Earth ID. Only valid if topic is geo.\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "place_ids", + "optional": "1", + "_content": "A comma-separated list of Flickr place IDs. Only valid if topic is geo.\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "lat", + "optional": "1", + "_content": "A latitude value, in decimal format. Only valid if topic is geo. Defines the latitude for a radial query centered around (lat, lon).\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "lon", + "optional": "1", + "_content": "A longitude value, in decimal format. Only valid if topic is geo. Defines the longitude for a radial query centered around (lat, lon).\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "radius", + "optional": "1", + "_content": "A radius value, in the units defined by radius_units. Only valid if topic is geo. Defines the radius of a circle for a radial query centered around (lat, lon). Default is 5 km.\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "radius_units", + "optional": "1", + "_content": "Defines the units for the radius parameter. Only valid if topic is geo. Options are mi and km. Default is km.\r\n

\r\nThe order of precedence for geo subscriptions is : woe ids, place ids, radial i.e. the lat, lon parameters will be ignored if place_ids is present, which will be ignored if woe_ids is present." + }, + { + "name": "accuracy", + "optional": "1", + "_content": "Defines the minimum accuracy required for photos to be included in a subscription. Only valid if topic is geo Legal values are 1-16, default is 1 (i.e. any accuracy level).\r\n
    \r\n
  • World level is 1
    • \r\n
  • Country is ~3
    • \r\n
  • Region is ~6
    • \r\n
  • City is ~11
    • \r\n
  • Street is ~16
    • \r\n
" + }, + { + "name": "nsids", + "optional": "1", + "_content": "A comma-separated list of nsids representing Flickr Commons institutions (see flickr.commons.getInstitutions). Only valid if topic is commons. If not present this argument defaults to all Flickr Commons institutions." + }, + { + "name": "tags", + "optional": "1", + "_content": "A comma-separated list of strings to be used for tag subscriptions. Photos with one or more of the tags listed will be included in the subscription. Only valid if the topic is tags." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One of the required arguments for the method was not provided." + }, + { + "code": "2", + "message": "Invalid parameter value", + "_content": "One of the arguments was specified with an illegal value." + }, + { + "code": "3", + "message": "Callback URL already in use for a different subscription", + "_content": "A different subscription already exists that uses the same callback URL." + }, + { + "code": "4", + "message": "Callback failed or invalid response", + "_content": "The verification callback failed, or failed to return the expected response to confirm the subscription." + }, + { + "code": "5", + "message": "Service currently available only to pro accounts", + "_content": "PuSH subscriptions are currently restricted to Pro account holders." + }, + { + "code": "6", + "message": "Subscription awaiting verification callback response - try again later", + "_content": "A subscription with those details exists already, but it is in a pending (non-verified) state. Please wait a bit for the verification callback to complete before attempting to update the subscription." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.push.unsubscribe.json": { + "method": { + "name": "flickr.push.unsubscribe", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Why would you want to do this?\r\n

\r\n(this method is experimental and may change)" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "topic", + "optional": "0", + "_content": "The type of subscription. See flickr.push.getTopics." + }, + { + "name": "callback", + "optional": "0", + "_content": "The url for the subscription endpoint (must be the same url as was used when creating the subscription)." + }, + { + "name": "verify", + "optional": "0", + "_content": "The verification mode, either 'sync' or 'async'. See the Google PubSubHubbub spec for details." + }, + { + "name": "verify_token", + "optional": "1", + "_content": "The verification token to be echoed back to the subscriber during the verification callback, as per the Google PubSubHubbub spec. Limited to 200 bytes." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Required parameter missing", + "_content": "One of the required arguments for the method was not provided." + }, + { + "code": "2", + "message": "Invalid parameter value", + "_content": "One of the arguments was specified with an illegal value." + }, + { + "code": "4", + "message": "Callback failed or invalid response", + "_content": "The verification callback failed, or failed to return the expected response to confirm the un-subscription." + }, + { + "code": "6", + "message": "Subscription awaiting verification callback response - try again later", + "_content": "A subscription with those details exists already, but it is in a pending (non-verified) state. Please wait a bit for the verification callback to complete before attempting to update the subscription." + }, + { + "code": "7", + "message": "Subscription not found", + "_content": "No subscription matching the provided details for this user could be found." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.reflection.getMethodInfo.json": { + "method": { + "name": "flickr.reflection.getMethodInfo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns information for a given flickr API method." + }, + "response": { + "_content": "\r\n\tA fake method \r\n\txml-response-example \r\n\texplanation of example response \r\n\t\r\n\t\t\r\n\t\t\tYou API application key. \r\n\t\t\r\n\t\t\tYour favorite color. \r\n\t\r\n\t\r\n\t\t\r\n\t\t\tFull explanation... \r\n\t\t\r\n\t\t\tFull explanation... \r\n\t\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "method_name", + "optional": "0", + "_content": "The name of the method to fetch information for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Method not found", + "_content": "The requested method was not found." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.reflection.getMethods.json": { + "method": { + "name": "flickr.reflection.getMethods", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of available flickr API methods." + }, + "response": { + "_content": "\r\n\tflickr.blogs.getList\r\n\tflickr.blogs.postPhoto\r\n\tflickr.contacts.getList\r\n\tflickr.contacts.getPublicList\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getCSVFiles.json": { + "method": { + "name": "flickr.stats.getCSVFiles", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of URLs for text files containing all your stats data (from November 26th 2007 onwards) for the currently auth'd user.\r\n\r\nPlease note, these files will only be available until June 1, 2010 Noon PDT. \r\nFor more information please check out this FAQ, or just go download your files." + }, + "response": { + "_content": " \r\n \r\n \r\n \r\n \r\n ....\r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getCollectionDomains.json": { + "method": { + "name": "flickr.stats.getCollectionDomains", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referring domains for a collection" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <domain> element for each referring domain, with attributes for the domain name and the number of views.

\r\n\r\n

For details on the referrers coming from each domain listed you can call flickr.stats.getCollectionReferrers

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "collection_id", + "optional": "1", + "_content": "The id of the collection to get stats for. If not provided, stats for all collections will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Collection not found", + "_content": "The collection id was either invalid or was for a collection not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getCollectionReferrers.json": { + "method": { + "name": "flickr.stats.getCollectionReferrers", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referrers from a given domain to a collection" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <referrer> element for each referring page, with attributes for the url and the number of views.

\r\n\r\n

Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. \r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "domain", + "optional": "0", + "_content": "The domain to return referrers for. This should be a hostname (eg: \"flickr.com\") with no protocol or pathname." + }, + { + "name": "collection_id", + "optional": "1", + "_content": "The id of the collection to get stats for. If not provided, stats for all collections will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Collection not found", + "_content": "The collection id was either invalid or was for a collection not owned by the calling user." + }, + { + "code": "5", + "message": "Invalid domain", + "_content": "The domain provided is not in the expected format." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getCollectionStats.json": { + "method": { + "name": "flickr.stats.getCollectionStats", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get the number of views on a collection for a given date." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "collection_id", + "optional": "0", + "_content": "The id of the collection to get stats for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Collection not found", + "_content": "The collection id was either invalid or was for a collection not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotoDomains.json": { + "method": { + "name": "flickr.stats.getPhotoDomains", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referring domains for a photo" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <domain> element for each referring domain, with attributes for the domain name and the number of views.

\r\n\r\n

For details on the referrers coming from each domain listed you can call flickr.stats.getPhotoReferrers

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "photo_id", + "optional": "1", + "_content": "The id of the photo to get stats for. If not provided, stats for all photos will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotoReferrers.json": { + "method": { + "name": "flickr.stats.getPhotoReferrers", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referrers from a given domain to a photo" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

There is one <referrer> element for each referring page, with attributes for the url and the number of views.

\r\n\r\n

Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "domain", + "optional": "0", + "_content": "The domain to return referrers for. This should be a hostname (eg: \"flickr.com\") with no protocol or pathname." + }, + { + "name": "photo_id", + "optional": "1", + "_content": "The id of the photo to get stats for. If not provided, stats for all photos will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not owned by the calling user." + }, + { + "code": "5", + "message": "Invalid domain", + "_content": "The domain provided is not in the expected format." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotoStats.json": { + "method": { + "name": "flickr.stats.getPhotoStats", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get the number of views, comments and favorites on a photo for a given date." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to get stats for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photo not found", + "_content": "The photo id was either invalid or was for a photo not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotosetDomains.json": { + "method": { + "name": "flickr.stats.getPhotosetDomains", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referring domains for a photoset" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <domain> element for each referring domain, with attributes for the domain name and the number of views.

\r\n\r\n

For details on the referrers coming from each domain listed you can call flickr.stats.getPhotosetReferrers

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "photoset_id", + "optional": "1", + "_content": "The id of the photoset to get stats for. If not provided, stats for all sets will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photoset not found", + "_content": "The photoset id was either invalid or was for a set not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotosetReferrers.json": { + "method": { + "name": "flickr.stats.getPhotosetReferrers", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referrers from a given domain to a photoset" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

There is one <referrer> element for each referring page, with attributes for the url and the number of views.

\r\n\r\n

Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. \r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "domain", + "optional": "0", + "_content": "The domain to return referrers for. This should be a hostname (eg: \"flickr.com\") with no protocol or pathname." + }, + { + "name": "photoset_id", + "optional": "1", + "_content": "The id of the photoset to get stats for. If not provided, stats for all sets will be returned." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photoset not found", + "_content": "The photoset id was either invalid or was for a set not owned by the calling user." + }, + { + "code": "5", + "message": "Invalid domain", + "_content": "The domain provided is not in the expected format." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotosetStats.json": { + "method": { + "name": "flickr.stats.getPhotosetStats", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get the number of views on a photoset for a given date." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "photoset_id", + "optional": "0", + "_content": "The id of the photoset to get stats for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "4", + "message": "Photoset not found", + "_content": "The photoset id was either invalid or was for a set not owned by the calling user." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotostreamDomains.json": { + "method": { + "name": "flickr.stats.getPhotostreamDomains", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referring domains for a photostream" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\r\n" + }, + "explanation": { + "_content": "

There is one <domain> element for each referring domain, with attributes for the domain name and the number of views.

\r\n\r\n

For details on the referrers coming from each domain listed you can call flickr.stats.getPhotostreamReferrers

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of domains to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100" + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotostreamReferrers.json": { + "method": { + "name": "flickr.stats.getPhotostreamReferrers", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get a list of referrers from a given domain to a user's photostream" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

There is one <referrer> element for each referring page, with attributes for the url and the number of views.

\r\n\r\n

Where the referring page is a search engine and we have identified the search term it will be given in the searchterm attribute.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. \r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + }, + { + "name": "domain", + "optional": "0", + "_content": "The domain to return referrers for. This should be a hostname (eg: \"flickr.com\") with no protocol or pathname." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "5", + "message": "Invalid domain", + "_content": "The domain provided is not in the expected format." + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPhotostreamStats.json": { + "method": { + "name": "flickr.stats.getPhotostreamStats", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get the number of views on a user's photostream for a given date." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "0", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getPopularPhotos.json": { + "method": { + "name": "flickr.stats.getPopularPhotos", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "List the photos with the most views, comments or favorites" + }, + "response": { + "_content": "\r\n\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\r\n" + }, + "explanation": { + "_content": "

This method returns the standard photo list xml.

\r\n\r\n

In addition each photo element contains a <stats> element. This has attributes for the view, comment and favorite counts for the requested day.

\r\n\r\n

To map <photo> elements to urls, please read the url documentation.

\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "1", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format. \r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.\r\n\r\nIf no date is provided, all time view counts will be returned." + }, + { + "name": "sort", + "optional": "1", + "_content": "The order in which to sort returned photos. Defaults to views. The possible values are views, comments and favorites. \r\n\r\nOther sort options are available through flickr.photos.search." + }, + { + "name": "per_page", + "optional": "1", + "_content": "Number of referrers to return per page. If this argument is omitted, it defaults to 25. The maximum allowed value is 100." + }, + { + "name": "page", + "optional": "1", + "_content": "The page of results to return. If this argument is omitted, it defaults to 1." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": "5", + "message": "Invalid sort", + "_content": "The sort provided is not valid" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.stats.getTotalViews.json": { + "method": { + "name": "flickr.stats.getTotalViews", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Get the overall view counts for an account" + }, + "response": { + "_content": "\r\n\t\r\n\t\r\n\t\r\n\t\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "date", + "optional": "1", + "_content": "Stats will be returned for this date. This should be in either be in YYYY-MM-DD or unix timestamp format.\r\n\r\nA day according to Flickr Stats starts at midnight GMT for all users, and timestamps will automatically be rounded down to the start of the day.\r\n\r\nIf no date is provided, all time view counts will be returned." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User does not have stats", + "_content": "The user you have requested stats has not enabled stats on their account." + }, + { + "code": "2", + "message": "No stats for that date", + "_content": "No stats are available for the date requested. Flickr only keeps stats data for the last 28 days." + }, + { + "code": "3", + "message": "Invalid date", + "_content": "The date provided could not be parsed" + }, + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getClusterPhotos.json": { + "method": { + "name": "flickr.tags.getClusterPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the first 24 photos for a given tag cluster" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tag", + "optional": "0", + "_content": "The tag that this cluster belongs to." + }, + { + "name": "cluster_id", + "optional": "0", + "_content": "The top three tags for the cluster, separated by dashes (just like the url)." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getClusters.json": { + "method": { + "name": "flickr.tags.getClusters", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Gives you a list of tag clusters for the given tag." + }, + "response": { + "_content": "\r\n\t\r\n\t\tfarm\r\n\t\tanimals\r\n\t\tcattle\r\n\t\r\n\t\r\n\t\tgreen\r\n\t\tlandscape\r\n\t\tcountryside\r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tag", + "optional": "0", + "_content": "The tag to fetch clusters for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Tag cluster not found", + "_content": "The tag was invalid or no cluster exists for that tag." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getHotList.json": { + "method": { + "name": "flickr.tags.getHotList", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of hot tags for the given period." + }, + "response": { + "_content": "\r\n\tnortherncalifornia\r\n\ttop20\r\n\tkeychain\r\n\tzb\r\n\tselfportraittuesday\r\n\tjan06\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "period", + "optional": "1", + "_content": "The period for which to fetch hot tags. Valid values are day and week (defaults to day)." + }, + { + "name": "count", + "optional": "1", + "_content": "The number of tags to return. Defaults to 20. Maximum allowed value is 200." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Invalid period", + "_content": "The specified period was not understood." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getListPhoto.json": { + "method": { + "name": "flickr.tags.getListPhoto", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the tag list for a given photo." + }, + "response": { + "_content": "\r\n\t\r\n\t\ttag1 \r\n\t\ttag2 \r\n\t\r\n" + }, + "explanation": { + "_content": "

For an explanation of the tag element, please read the tags documentation.

" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "photo_id", + "optional": "0", + "_content": "The id of the photo to return tags for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Photo not found", + "_content": "The photo id passed was not a valid photo id." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getListUser.json": { + "method": { + "name": "flickr.tags.getListUser", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the tag list for a given user (or the currently logged in user)." + }, + "response": { + "_content": "\r\n\t\r\n\t\tgull \r\n\t\ttag1 \r\n\t\ttag2 \r\n\t\ttags \r\n\t\ttest \r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user to fetch the tag list for. If this argument is not specified, the currently logged in user (if any) is assumed." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user NSID passed was not a valid user NSID and the calling user was not logged in.\r\n" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getListUserPopular.json": { + "method": { + "name": "flickr.tags.getListUserPopular", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the popular tags for a given user (or the currently logged in user)." + }, + "response": { + "_content": "\r\n\t\r\n\t\tbar \r\n\t\tfoo \r\n\t\tgull \r\n\t\ttags \r\n\t\ttest \r\n\t\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user to fetch the tag list for. If this argument is not specified, the currently logged in user (if any) is assumed." + }, + { + "name": "count", + "optional": "1", + "_content": "Number of popular tags to return. defaults to 10 when this argument is not present." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The user NSID passed was not a valid user NSID and the calling user was not logged in.\r\n" + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getListUserRaw.json": { + "method": { + "name": "flickr.tags.getListUserRaw", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Get the raw versions of a given tag (or all tags) for the currently logged-in user." + }, + "response": { + "_content": "\r\n \r\n \r\n foo\r\n Foo\r\n f:oo\r\n \r\n \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tag", + "optional": "1", + "_content": "The tag you want to retrieve all raw versions for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The calling user was not logged in." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getMostFrequentlyUsed.json": { + "method": { + "name": "flickr.tags.getMostFrequentlyUsed", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Returns a list of most frequently used tags for a user." + }, + "response": { + "_content": "\r\n\r\n\t\r\n\t\tblah\r\n\t\tpublicdomain\r\n\t\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.tags.getRelated.json": { + "method": { + "name": "flickr.tags.getRelated", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a list of tags 'related' to the given tag, based on clustered usage analysis." + }, + "response": { + "_content": "\r\n\tengland\r\n\tthames\r\n\ttube\r\n\tbigben\r\n\tuk\r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "tag", + "optional": "0", + "_content": "The tag to fetch related tags for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Tag not found", + "_content": "The tag argument was missing." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.test.echo.json": { + "method": { + "name": "flickr.test.echo", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "A testing method which echo's all parameters back in the response." + }, + "response": { + "_content": "echo\r\nbar" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.test.login.json": { + "method": { + "name": "flickr.test.login", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "A testing method which checks if the caller is logged in then returns their username." + }, + "response": { + "_content": "\r\n\tBees \r\n\r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.test.null.json": { + "method": { + "name": "flickr.test.null", + "needslogin": 1, + "needssigning": 1, + "requiredperms": "1", + "description": { + "_content": "Null test" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + } + ] + }, + "errors": { + "error": [ + { + "code": 95, + "message": "SSL is required", + "_content": "SSL is required to access the Flickr API." + }, + { + "code": 96, + "message": "Invalid signature", + "_content": "The passed signature was invalid." + }, + { + "code": 97, + "message": "Missing signature", + "_content": "The call required signing but no signature was sent." + }, + { + "code": 98, + "message": "Login failed / Invalid auth token", + "_content": "The login details or auth token passed were invalid." + }, + { + "code": 99, + "message": "User not logged in / Insufficient permissions", + "_content": "The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.getGroup.json": { + "method": { + "name": "flickr.urls.getGroup", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the url to a group's page." + }, + "response": { + "_content": " " + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "group_id", + "optional": "0", + "_content": "The NSID of the group to fetch the url for." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The NSID specified was not a valid group." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.getUserPhotos.json": { + "method": { + "name": "flickr.urls.getUserPhotos", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the url to a user's photos." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user to fetch the url for. If omitted, the calling user is assumed." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The NSID specified was not a valid user." + }, + { + "code": "2", + "message": "No user specified", + "_content": "No user_id was passed and the calling user was not logged in." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.getUserProfile.json": { + "method": { + "name": "flickr.urls.getUserProfile", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns the url to a user's profile." + }, + "response": { + "_content": "" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "user_id", + "optional": "1", + "_content": "The NSID of the user to fetch the url for. If omitted, the calling user is assumed." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The NSID specified was not a valid user." + }, + { + "code": "2", + "message": "No user specified", + "_content": "No user_id was passed and the calling user was not logged in." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.lookupGallery.json": { + "method": { + "name": "flickr.urls.lookupGallery", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns gallery info, by url." + }, + "response": { + "_content": "\r\n\tCat Pictures I've Sent To Kevin Collins\r\n\t\r\n" + }, + "explanation": { + "_content": "This is the same format returned by flickr.galleries.getInfo." + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "url", + "optional": "0", + "_content": "The gallery's URL." + } + ] + }, + "errors": { + "error": [ + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.lookupGroup.json": { + "method": { + "name": "flickr.urls.lookupGroup", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a group NSID, given the url to a group's page or photo pool." + }, + "response": { + "_content": "\r\n\tFlickrCentral \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "url", + "optional": "0", + "_content": "The url to the group's page or photo pool." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "Group not found", + "_content": "The passed URL was not a valid group page or photo pool url." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + }, + "methods/flickr.urls.lookupUser.json": { + "method": { + "name": "flickr.urls.lookupUser", + "needslogin": 0, + "needssigning": 0, + "requiredperms": 0, + "description": { + "_content": "Returns a user NSID, given the url to a user's photos or profile." + }, + "response": { + "_content": "\r\n\tStewart \r\n" + } + }, + "arguments": { + "argument": [ + { + "name": "api_key", + "optional": 0, + "_content": "Your API application key. See here for more details." + }, + { + "name": "url", + "optional": "0", + "_content": "The url to the user's profile or photos page." + } + ] + }, + "errors": { + "error": [ + { + "code": "1", + "message": "User not found", + "_content": "The passed URL was not a valid user profile or photos url." + }, + { + "code": 100, + "message": "Invalid API Key", + "_content": "The API key passed was not valid or has expired." + }, + { + "code": 105, + "message": "Service currently unavailable", + "_content": "The requested service is temporarily unavailable." + }, + { + "code": 106, + "message": "Write operation failed", + "_content": "The requested operation failed due to a temporary issue." + }, + { + "code": 111, + "message": "Format \"xxx\" not found", + "_content": "The requested response format was not found." + }, + { + "code": 112, + "message": "Method \"xxx\" not found", + "_content": "The requested method was not found." + }, + { + "code": 114, + "message": "Invalid SOAP envelope", + "_content": "The SOAP envelope send in the request could not be parsed." + }, + { + "code": 115, + "message": "Invalid XML-RPC Method Call", + "_content": "The XML-RPC request document could not be parsed." + }, + { + "code": 116, + "message": "Bad URL found", + "_content": "One or more arguments contained a URL that has been used for abuse on Flickr." + } + ] + }, + "stat": "ok" + } +} \ No newline at end of file diff --git a/package.json b/package.json index cd455a2..46786f2 100755 --- a/package.json +++ b/package.json @@ -4,8 +4,6 @@ "author": "Pomax ", "description": "A Node.js, and client-side, implementation of the Flickr API (for use with an API key, server-side oauth enabled)", "dependencies": { - "async": "~0.2.10", - "glob": "~3.2.6", "open": "0.0.x", "progress": "1.1.4", "prompt": "0.2.x", diff --git a/src/flickr-api-object.js b/src/flickr-api-object.js index af746f9..6c0149a 100644 --- a/src/flickr-api-object.js +++ b/src/flickr-api-object.js @@ -6,6 +6,7 @@ module.exports = (function() { "use strict"; var fs = require("fs"), + cache = require(__dirname + "/../built-api.js"), Progress = require("progress"), progressBar, API = {}, @@ -85,6 +86,11 @@ module.exports = (function() { parseMethods(flickrOptions, methods, method_idx+1, finished); }; + var cacheKey = "methods/" + method_name + ".json"; + if(cache[cacheKey]) { + return handleResult(cache[cacheKey]); + } + // do we have this method definition cached? if(fs.existsSync(filename)) { var methodDefinition = JSON.parse(fs.readFileSync(filename)); @@ -126,6 +132,11 @@ module.exports = (function() { return parseMethods(flickrOptions, methods, 0, finished); }; + var cacheKey = "flickr.reflection.getMethods.json"; + if(cache[cacheKey]) { + return handleResults(cache[cacheKey]); + } + var mdir = "./data/flickr", filename = mdir + "/flickr.reflection.getMethods.json"; if(fs.existsSync(filename)) { diff --git a/src/glob.js b/src/glob.js new file mode 100644 index 0000000..28ea7f0 --- /dev/null +++ b/src/glob.js @@ -0,0 +1,30 @@ +var fs = require("fs"), + path = require("path"); + +module.exports = function(root, pattern) { + function walk(dir) { + if (!fs.existsSync(dir)) { + return; + } + + var list = fs.readdirSync(dir); + if (!list.length) { + return; + } + for (var i = 0, len = list.length; i < len; i++) { + var file = list[i], + fullpath = path.resolve(dir, file); + if (fs.statSync(fullpath).isDirectory()) { + walk(fullpath); + continue; + } + if (fullpath.contains(pattern)) { + files.push(fullpath); + } + } + return files + } + + var files = []; + return walk(root); +} diff --git a/src/handlers/downsync/photos.js b/src/handlers/downsync/photos.js index a338993..ee6d1cf 100644 --- a/src/handlers/downsync/photos.js +++ b/src/handlers/downsync/photos.js @@ -1,8 +1,7 @@ -var async = require("async"), - fs = require("fs"), +var fs = require("fs"), download = require("./download").downloadPhoto, getSetMetadata = require("./sets"), - glob = require("glob"), + glob = require("../glob.js"), progress = require("progress"), progressBarAggregate, progressBar, @@ -222,12 +221,8 @@ function aggregatePhotos(flickr, options) { } // prune the remaining photos keys.forEach(function(key) { - var match = dirs.root + "/**/" + key + ".*"; - glob(match, function (err, files) { - if(err) { return console.error(err); } - files.forEach(function(file) { - fs.unlink( file, function(err, result){ if(err) { console.error(err); }}); - }); + glob(dirs.root, key).forEach(function(file) { + fs.unlink( file, function(err){ if(err) { console.error(err); }}); }); }); }