Flickr: Scheme API for Flickr

David Van Horn <dvanhorn@ccs.neu.edu>

1 Overview

2 Example

3 Methods

(require (planet dvanhorn/flickr:2:2))

1 Overview

This collection provides a Scheme wrapping to the Flickr web service:

http://www.flickr.com/services/api/

Procedures are named exactly as in the Flickr API. Arguments are specified with keywords spelled exactly as in the API, their values must always be strings.

Calling a procedure returns a list of Xexprs constituting the [xml-payload-here] portion of the response (see the Flickr documentation on example responses).

Here is an example call to the echo method (the value of the api_key should be changed to your own key, assigned by Flickr).

Example:
> (flickr.test.echo #:api_key "138427ce2d97d6a2d0c4a2f045a59bfa")
((method () "flickr.test.echo") (api_key () "138427ce2d97d6a2d0c4a2f045a59bfa"))

If the Flickr service responds with an error response, an exception is raised.

(current-api-key) → string?

(current-api-key api-key) → void?

api-key : string?

The api_key argument is required of every method in the Flickr API. If ommitted from a Scheme procedure call, the value defaults to the value of the current-api-key parameter. So the above could be written as:

Examples:
  > (current-api-key "138427ce2d97d6a2d0c4a2f045a59bfa")
  > (flickr.test.echo)
  ((method () "flickr.test.echo") (api_key () "138427ce2d97d6a2d0c4a2f045a59bfa"))

Methods may have required arguments and an error will be raised if ommitted.

(current-sec-key) → string?

(current-sec-key sec-key) → void?

sec-key : string?

Signed methods rely on the current-sec-key parameter for the Flickr API secret key.

(signed?) → boolean?

(signed? v) → void?

v : boolean?

When true, all methods are signed; when false, only methods that need signing are signed.

2 Example

See example.ss for a example program that logs in a user and makes authenticated calls to the API.

To run:

mred-text -p dvanhorn/flickr/example

3 Methods

(flickr.activity.userComments	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of recent activity on photos commented on by the calling user. Do not poll this method more than once an hour.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
per_page – Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Response:

((items

()

(item

((comments "1")

(id "395")

(more "0")

(owner "12037949754@N01")

(photos "7")

(primary "6521")

(secret "5a3cc65d72")

(server "2")

(type "photoset")

(views "33"))

(title () "A set of photos")

(activity

()

(event

((dateadded "1144086424")

(type "comment")

(user "12037949754@N01")

(username "Bees"))

"yay")))

(item

((comments "1")

(faves "0")

(id "10289")

(more "0")

(notes "0")

(owner "12037949754@N01")

(secret "34da0d3891")

(server "2")

(type "photo")

(views "47"))

(title () "A photo")

(activity

()

(event

((dateadded "1133806604")

(type "comment")

(user "12037949754@N01")

(username "Bees"))

"test")

(event

((dateadded "1118785229")

(type "note")

(user "12037949754@N01")

(username "Bees"))

"nice")))))

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.activity.userComments

API Explorer: flickr.activity.userComments

(flickr.activity.userPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:timeframe timeframe
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

timeframe : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of recent activity on photos belonging to the calling user. Do not poll this method more than once an hour.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
timeframe – The timeframe in which to return updates for. This can be specified in days (<code>’2d’</code>) or hours (<code>’4h’</code>). The default behavoir is to return changes since the beginning of the previous user session.
per_page – Number of items to return per page. If this argument is omitted, it defaults to 10. The maximum allowed value is 50.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Response:

((items

()

(item

((commentsnew "1")

(commentsold "1")

(id "395")

(more "0")

(owner "12037949754@N01")

(photos "7")

(primary "6521")

(secret "5a3cc65d72")

(server "2")

(type "photoset")

(views "33"))

(title () "A set of photos")

(activity

()

(event

((dateadded "1144086424")

(type "comment")

(user "12037949754@N01")

(username "Bees"))

"yay")))

(item

((commentsnew "1")

(commentsold "1")

(faves "0")

(id "10289")

(more "0")

(notesnew "1")

(notesold "0")

(owner "12037949754@N01")

(secret "34da0d3891")

(server "2")

(type "photo")

(views "47"))

(title () "A photo")

(activity

()

(event

((dateadded "1133806604")

(type "comment")

(user "12037949754@N01")

(username "Bees"))

"test")

(event

((dateadded "1118785229")

(type "note")

(user "12037949754@N01")

(username "Bees"))

"nice")))))

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.activity.userPhotos

API Explorer: flickr.activity.userPhotos

(flickr.auth.checkToken	[	#:api_sig api_sig
		#:api_key api_key]
		#:auth_token auth_token)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

api_key : string? = (current-api-key)

auth_token : string?

Returns the credentials attached to an authentication token. This call must be signed as specified in the <a href="/services/api/auth.spec.html">authentication API spec</a>.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
auth_token – The authentication token to check.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((auth

()

(token () "976598454353455")

(perms () "read")

(user ((fullname "Cal H") (nsid "12037949754@N01") (username "Bees")))))

Explanation: <code>perms</code> can have values of <code>none</code>, <code>read</code>, <code>write</code> or <code>delete</code>. For more information, see the <a href="/services/api/auth.spec.html">Auth API spec</a>.

Error codes:

98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.auth.checkToken

API Explorer: flickr.auth.checkToken

(flickr.auth.getFrob	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key])	→	(listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

Returns a frob to be used during authentication. This method call must be signed.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((frob () "746563215463214621"))

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.auth.getFrob

API Explorer: flickr.auth.getFrob

(flickr.auth.getFullToken	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:mini_token mini_token)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

mini_token : string?

Get the full authentication token for a mini-token. This method call must be signed.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
mini_token – The mini-token typed in by a user. It should be 9 digits long. It may optionally contain dashes.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((auth

()

(token () "976598454353455")

(perms () "write")

(user ((fullname "Cal H") (nsid "12037949754@N01") (username "Bees")))))

Error codes:

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

Flickr API: flickr.auth.getFullToken

API Explorer: flickr.auth.getFullToken

(flickr.auth.getToken	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:frob frob)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

frob : string?

Returns the auth token for the given frob, if one has been attached. This method call must be signed.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
frob – The frob to check.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((auth

()

(token () "976598454353455")

(perms () "write")

(user ((fullname "Cal H") (nsid "12037949754@N01") (username "Bees")))))

Error codes:

108 – Invalid frob: The specified frob does not exist or has already been used.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.auth.getToken

API Explorer: flickr.auth.getToken

(flickr.blogs.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:service service])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

service : (or/c #f string?) = #f

Get a list of configured blogs for the calling user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
service – Optionally only return blogs for a given service id. You can get a list of from <a href="/services/api/flickr.blogs.getServices.html">flickr.blogs.getServices()</a>.

Authentication:

This method needs login.

This method needs signing.

Response:

((blogs

()

(blog

((id "73")

(name "Bloxus test")

(needspassword "0")

(url "http://remote.bloxus.com/")))

(blog

((id "74")

(name "Manila Test")

(needspassword "1")

(url "http://flickrtest1.userland.com/")))))

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

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.blogs.getList

API Explorer: flickr.blogs.getList

(flickr.blogs.getServices	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

Return a list of Flickr supported blogging services

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((services

()

(service ((id "beta.blogger.com")) "Blogger")

(service ((id "Typepad")) "Typepad")

(service ((id "MovableType")) "Movable Type")

(service ((id "LiveJournal")) "LiveJournal")

(service ((id "MetaWeblogAPI")) "Wordpress")

(service ((id "MetaWeblogAPI")) "MetaWeblogAPI")

(service ((id "Manila")) "Manila")

(service ((id "AtomAPI")) "AtomAPI")

(service ((id "BloggerAPI")) "BloggerAPI")

(service ((id "Vox")) "Vox")

(service ((id "Twitter")) "Twitter")))

Error codes:

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

Flickr API: flickr.blogs.getServices

API Explorer: flickr.blogs.getServices

(flickr.blogs.postPhoto	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:blog_id blog_id]
		#:photo_id photo_id
		#:title title
		#:description description
	[	#:blog_password blog_password
		#:service service])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

blog_id : (or/c #f string?) = #f

photo_id : string?

title : string?

description : string?

blog_password : (or/c #f string?) = #f

service : (or/c #f string?) = #f

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
blog_id – The id of the blog to post to.
photo_id – The id of the photo to blog
title – The blog post title
description – The blog post body
blog_password – The password for the blog (used when the blog does not have a stored password).
service – 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.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Blog not found: The blog id was not the id of a blog belonging to the calling user
2 – Photo not found: The photo id was not the id of a public photo
3 – Password needed: A password is not stored for the blog and one was not passed with the request
4 – Blog post failed: The blog posting failed (a blogging API failure of some sort)
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.blogs.postPhoto

API Explorer: flickr.blogs.postPhoto

(flickr.collections.getInfo	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:collection_id collection_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

collection_id : string?

Returns information for a single collection. Currently can only be called by the collection owner, this may change.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
collection_id – The ID of the collection to fetch information for.

Authentication:

This method needs login.

This method needs signing.

Response:

"MALFORMED RESPONSE"

Error codes:

1 – Collection not found: The requested collection could not be found or is not visible to the calling user.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.collections.getInfo

API Explorer: flickr.collections.getInfo

(flickr.collections.getTree	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:collection_id collection_id
		#:user_id user_id])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

collection_id : (or/c #f string?) = #f

user_id : (or/c #f string?) = #f

Returns a tree (or sub tree) of collections belonging to a given user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
collection_id – The ID of the collection to fetch a tree for, or zero to fetch the root collection. Defaults to zero.
user_id – The ID of the account to fetch the collection tree for. Deafults to the calling user.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((collections

()

(collection

((description "a collection")

(iconlarge "http://farm1.static.flickr.com/187/cols/37_43fac2cf79_l.jpg")

(iconsmall "http://farm1.static.flickr.com/187/cols/56_43fac2cf79_s.jpg")

(id "12-72157594586579649")

(title "All My Photos"))

(set ((description "a set") (id "92157594171298291") (title "kitesurfing")))

(set

((description "some favorites.")

(id "72157594247596158")

(title "faves"))))))

Explanation: A nested tree of collections, and the collections and sets they contain.

Error codes:

1 – User not found: The specified user could not be found.
2 – Collection not found: The specified collection does not exist.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.collections.getTree

API Explorer: flickr.collections.getTree

(flickr.commons.getInstitutions	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

Retrieves a list of the current Commons institutions.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((rsp

((stat "ok"))

(institutions

()

(institution

((date_launch "1232000000") (nsid "123456@N01"))

(name () "Institution")

(urls

()

(url ((type "site")) "http://example.com/")

(url ((type "license")) "http://example.com/commons/license")

(url ((type "flickr")) "http://flickr.com/photos/institution"))))))

Error codes:

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

Flickr API: flickr.commons.getInstitutions

API Explorer: flickr.commons.getInstitutions

(flickr.contacts.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:filter filter
		#:page page
		#:per_page per_page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

filter : (or/c #f string?) = #f

page : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

Get a list of contacts for the calling user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
filter – An optional filter of the results. The following values are valid:   <dl><dt><code>friends</code></dt><dl>Only contacts who are friends (and not family)</dl><dt><code>family</code></dt><dl>Only contacts who are family (and not friends)</dl><dt><code>both</code></dt><dl>Only contacts who are both friends and family</dl><dt><code>neither</code></dt><dl>Only contacts who are neither friends nor family</dl></dl>
page – The page of results to return. If this argument is omitted, it defaults to 1.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000.

Authentication:

This method needs login.

This method needs signing.

Response:

((contacts

((page "1") (pages "1") (perpage "1000") (total "3"))

(contact

((family "0")

(friend "1")

(iconserver "1")

(ignored "1")

(nsid "12037949629@N01")

(realname "Eric Costello")

(username "Eric")))

(contact

((family "0")

(friend "0")

(iconserver "1")

(ignored "0")

(nsid "12037949631@N01")

(realname "Ben Cerveny")

(username "neb")))

(contact

((family "1")

(friend "1")

(iconserver "1")

(ignored "0")

(nsid "41578656547@N01")

(realname "Cal Henderson")

(username "cal_abc")))))

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.contacts.getList

API Explorer: flickr.contacts.getList

(flickr.contacts.getListRecentlyUploaded
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:date_lastupload date_lastupload
		#:filter filter])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

date_lastupload : (or/c #f string?) = #f

filter : (or/c #f string?) = #f

Return a list of contacts for a user who have recently uploaded photos along with the total count of photos uploaded. This 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.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
date_lastupload – Limits the resultset to contacts that have uploaded photos since this date. The date should be in the form of a Unix timestamp. The default offset is (1) hour and the maximum (24) hours.
filter – Limit the result set to all contacts or only those who are friends or family. Valid options are: <ul><li>ff friends and family</li><li>all all your contacts</li></ul> Default value is "all".

Authentication:

This method needs login.

This method needs signing.

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.contacts.getListRecentlyUploaded

API Explorer: flickr.contacts.getListRecentlyUploaded

(flickr.contacts.getPublicList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:page page
		#:per_page per_page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

page : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

Get the contact list for a user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to fetch the contact list for.
page – The page of results to return. If this argument is omitted, it defaults to 1.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 1000. The maximum allowed value is 1000.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((contacts

((page "1") (pages "1") (perpage "1000") (total "3"))

(contact

((iconserver "1") (ignored "1") (nsid "12037949629@N01") (username "Eric")))

(contact

((iconserver "1") (ignored "0") (nsid "12037949631@N01") (username "neb")))

(contact

((iconserver "1")

(ignored "0")

(nsid "41578656547@N01")

(username "cal_abc")))))

Explanation: See <a href="/services/api/flickr.contacts.getList.html">flickr.contacts.getList</a> for an explanation of the response.

Error codes:

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

Flickr API: flickr.contacts.getPublicList

API Explorer: flickr.contacts.getPublicList

(flickr.favorites.add	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Adds a photo to a user’s favorites list.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to add to the user’s favorites.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id passed was not a valid photo id.
2 – Photo is owned by you: The photo belongs to the user and so cannot be added to their favorites.
3 – Photo is already in favorites: The photo is already in the user’s list of favorites.
4 – User cannot see photo: The user does not have permission to add the photo to their favorites.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.favorites.add

API Explorer: flickr.favorites.add

(flickr.favorites.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:user_id user_id
		#:min_fave_date min_fave_date
		#:max_fave_date max_fave_date
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : (or/c #f string?) = #f

min_fave_date : (or/c #f string?) = #f

max_fave_date : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of the user’s favorite photos. Only photos which the calling user has permission to see are returned.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to fetch the favorites list for. If this argument is omitted, the favorites list for the calling user is returned.
min_fave_date – Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp.
max_fave_date – Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – User not found: The specified user NSID was not a valid flickr user.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.favorites.getList

API Explorer: flickr.favorites.getList

(flickr.favorites.getPublicList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:min_fave_date min_fave_date
		#:max_fave_date max_fave_date
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

min_fave_date : (or/c #f string?) = #f

max_fave_date : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of favorite public photos for the given user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The user to fetch the favorites list for.
min_fave_date – Minimum date that a photo was favorited on. The date should be in the form of a unix timestamp.
max_fave_date – Maximum date that a photo was favorited on. The date should be in the form of a unix timestamp.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Error codes:

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

Flickr API: flickr.favorites.getPublicList

API Explorer: flickr.favorites.getPublicList

(flickr.favorites.remove	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Removes a photo from a user’s favorites list.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to remove from the user’s favorites.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not in favorites: The photo id passed was not in the user’s favorites.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.favorites.remove

API Explorer: flickr.favorites.remove

(flickr.galleries.addPhoto	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id
		#:photo_id photo_id
	[	#:comment comment])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

photo_id : string?

comment : (or/c #f string?) = #f

Add a photo to a gallery.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like <a href="/services/api/flickr.galleries.getList.html">flickr.galleries.getList</a>, and <a href="/services/api/flickr.galleries.getListForPhoto.html">flickr.galleries.getListForPhoto</a>.
photo_id – The photo ID to add to the gallery
comment – A short comment or story to accompany the photo.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Required parameter missing: One or more required parameters was not included with your API call.
2 – Invalid gallery ID: That gallery could not be found.
3 – Invalid photo ID: The requested photo could not be found.
4 – Invalid comment: The comment body could not be validated.
5 – Failed to add photo: Unable to add the photo to the gallery.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.galleries.addPhoto

API Explorer: flickr.galleries.addPhoto

(flickr.galleries.create	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:title title
		#:description description
	[	#:primary_photo_id primary_photo_id])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

title : string?

description : string?

primary_photo_id : (or/c #f string?) = #f

Create a new gallery for the calling user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
title – The name of the gallery
description – A short description for the gallery
primary_photo_id – The first photo to add to your gallery

Authentication:

This method needs login.

This method needs signing.

Response:

((gallery

((id "50736-72157623680420409")

(url "http://www.flickr.com/photos/kellan/galleries/72157623680420409"))))

Explanation: The ID of the newly created gallery, and its URL.

Error codes:

1 – Required parameter missing: One or more of the required parameters was missing from your API call.
2 – Invalid title or description: The title or the description could not be validated.
3 – Failed to add gallery: There was a problem creating the gallery.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.galleries.create

API Explorer: flickr.galleries.create

(flickr.galleries.editMeta	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id
		#:title title
	[	#:description description])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

title : string?

description : (or/c #f string?) = #f

Modify the meta-data for a gallery.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – The gallery ID to update.
title – The new title for the gallery.
description – The new description for the gallery.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Required parameter missing: One or more required parameters was missing from your request.
2 – Invalid title or description: The title or description arguments could not be validated.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.galleries.editMeta

API Explorer: flickr.galleries.editMeta

(flickr.galleries.editPhoto	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id
		#:photo_id photo_id
		#:comment comment)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

photo_id : string?

comment : string?

Edit the comment for a gallery photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – 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.
photo_id – The photo ID to add to the gallery.
comment – The updated comment the photo.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Invalid gallery ID: That gallery could not be found.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.galleries.editPhoto

API Explorer: flickr.galleries.editPhoto

(flickr.galleries.editPhotos
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id
		#:primary_photo_id primary_photo_id
		#:photo_ids photo_ids)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

primary_photo_id : string?

photo_ids : string?

Modify the photos in a gallery. Use this method to add, remove and re-order photos.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – The id of the gallery to modify. The gallery must belong to the calling user.
primary_photo_id – 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.
photo_ids – 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.

Authentication:

This method needs login.

This method needs signing.

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.galleries.editPhotos

API Explorer: flickr.galleries.editPhotos

(flickr.galleries.getInfo	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – The gallery ID you are requesting information for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((gallery

((count_photos "17")

(count_videos "0")

(date_create "1241028772")

(date_update "1270111667")

(id "6065-72157617483228192")

(owner "35034348999@N01")

(primary_photo_farm "1")

(primary_photo_id "292882708")

(primary_photo_secret "7f29861bc4")

(primary_photo_server "112")

(url "http://www.flickr.com/photos/straup/galleries/72157617483228192"))

(title () "Cat Pictures I've Sent To Kevin Collins")

(description ())))

Error codes:

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

Flickr API: flickr.galleries.getInfo

API Explorer: flickr.galleries.getInfo

(flickr.galleries.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

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

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to get a galleries list for. If none is specified, the calling user is assumed.
per_page – Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

"MALFORMED RESPONSE"

Error codes:

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

Flickr API: flickr.galleries.getList

API Explorer: flickr.galleries.getList

(flickr.galleries.getListForPhoto	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
	[	#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

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.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The ID of the photo to fetch a list of galleries for.
per_page – Number of galleries to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

"MALFORMED RESPONSE"

Error codes:

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

Flickr API: flickr.galleries.getListForPhoto

API Explorer: flickr.galleries.getListForPhoto

(flickr.galleries.getPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:gallery_id gallery_id
	[	#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

gallery_id : string?

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return the list of photos for a gallery

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
gallery_id – The ID of the gallery of photos to return
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photos

((page "1") (pages "1") (perpage "500") (total "2"))

(photo

((farm "1")

(has_comment "1")

(id "2822546461")

(is_primary "1")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "78398753@N00")

(secret "2dbcdb589f")

(server "1")

(title "FOO"))

(comment () "best cat picture ever!"))

(photo

((farm "1")

(has_comment "0")

(id "2822544806")

(is_primary "0")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "78398753@N00")

(secret "bd93cbe917")

(server "1")

(title "OOK")))))

Explanation: Returns a <a href="http://code.flickr.com/blog/2008/08/19/standard-photos-response-apis-for-civilized-age/">standard photo response</a>. Additionally if the gallery creator has included a comment with the photo this will be then the photo element will have the attribute has_comment="1" and the child element "comment" will be present.

Error codes:

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

Flickr API: flickr.galleries.getPhotos

API Explorer: flickr.galleries.getPhotos

(flickr.groups.browse	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:cat_id cat_id])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

cat_id : (or/c #f string?) = #f

Browse the group category tree, finding groups and sub-categories.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
cat_id – 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.

Authentication:

This method needs login.

This method needs signing.

Response:

((category

((name "Alt") (path "/Alt") (pathids "/63"))

(subcat ((count "0") (id "80") (name "18+")))

(subcat ((count "4") (id "82") (name "Absurd")))

(group

((chatnsid "34955637533@N01")

(inchat "0")

(members "13")

(name "Cal's Public Test Group")

(nsid "34955637532@N01")

(online "1")))

(group

((chatnsid "34158032588@N01")

(inchat "0")

(members "3")

(name "Eric's Alt Group Test")

(nsid "34158032587@N01")

(online "0")))))

Explanation: The <code>count</code> attribute of the <code>subcat</code> element gives the number of groups inside the subcat.The <code>members</code> attribute of the <code>group</code> element gives the total number of members in the group. The <code>online</code> attribute gives a count of the members who are currently online. The <code>inchat</code> attribute gives a count of the number of people in the group’s chat, regardless of whether they are members of the group.

Error codes:

1 – Category not found: The value passed for cat_id was not a valid category id.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.browse

API Explorer: flickr.groups.browse

(flickr.groups.getInfo	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:group_id group_id
	[	#:lang lang])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

group_id : string?

lang : (or/c #f string?) = #f

Get information about a group.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
group_id – The NSID of the group to fetch information for.
lang – 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. Valid values are the same as <a href="/services/feeds/">in feeds</a>.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((group

((iconserver "1")

(id "34427465497@N01")

(ispoolmoderated "0")

(lang "en-us"))

(name () "GNEverybody")

(description () "The group for GNE players")

(members () "69")

(privacy () "3")

(throttle ((count "10") (mode "month") (remaining "3")))))

Error codes:

1 – Group not found: 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.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.getInfo

API Explorer: flickr.groups.getInfo

(flickr.groups.members.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:group_id group_id
	[	#:membertypes membertypes
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

group_id : string?

membertypes : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

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.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
group_id – 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.
membertypes – Comma separated list of member types <ul><li>2: member</li><li>3: moderator</li><li>4: admin</li></ul> By default returns all types. (Returning super rare member type "1: narwhal" isn’t supported by this API method)
per_page – Number of members to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Response:

((members

((page "1") (pages "1") (perpage "100") (total "33"))

(member

((iconfarm "1")

(iconserver "1")

(membertype "2")

(nsid "123456@N01")

(username "foo")))

(member

((iconfarm "0")

(iconserver "0")

(membertype "4")

(nsid "118210@N07")

(username "kewlchops666")))

(member

((iconfarm "0")

(iconserver "0")

(membertype "2")

(nsid "119377@N07")

(username "Alpha Shanan")))

(member

((iconfarm "2")

(iconserver "1003")

(membertype "3")

(nsid "67783977@N00")

(username "fakedunstanp1")))

"\r\n...\r\n"))

Error codes:

1 – Group not found:
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.members.getList

API Explorer: flickr.groups.members.getList

(flickr.groups.pools.add	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:group_id group_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

group_id : string?

Add a photo to a group’s pool.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to add to the group pool. The photo must belong to the calling user.
group_id – The NSID of the group who’s pool the photo is to be added to.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id passed was not the id of a photo owned by the caling user.
2 – Group not found: The group id passed was not a valid id for a group the user is a member of.
3 – Photo already in pool: The specified photo is already in the pool for the specified group.
4 – Photo in maximum number of pools: The photo has already been added to the maximum allowed number of pools.
5 – Photo limit reached: The user has already added the maximum amount of allowed photos to the pool.
6 – Your Photo has been added to the Pending Queue for this Pool: 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.
7 – Your Photo has already been added to the Pending Queue for this Pool: The pool is moderated, and the photo has already been added to the Pending Queue.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.pools.add

API Explorer: flickr.groups.pools.add

(flickr.groups.pools.getContext	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:group_id group_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

group_id : string?

Returns next and previous photos for a photo in a group pool.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to fetch the context for.
group_id – The nsid of the group who’s pool to fetch the photo’s context for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((prevphoto

((id "2980")

(secret "973da1e709")

(title "boo!")

(url "/photos/bees/2980/"))))

Explanation: See <a href="/services/api/flickr.photos.getContext.html">flickr.photos.getContext</a>

Error codes:

1 – Photo not found: 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.
2 – Photo not in pool: The specified photo is not in the specified group’s pool.
3 – Group not found: The specified group nsid was not a valid group or the caller does not have permission to view the group’s pool.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.pools.getContext

API Explorer: flickr.groups.pools.getContext

(flickr.groups.pools.getGroups	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:page page
		#:per_page per_page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

page : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

Returns a list of groups to which you can add photos.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
page – The page of results to return. If this argument is omitted, it defaults to 1.
per_page – Number of groups to return per page. If this argument is omitted, it defaults to 400. The maximum allowed value is 400.

Authentication:

This method needs login.

This method needs signing.

Response:

((groups

((page "1") (pages "1") (per_page "400") (total "3"))

(group

((admin "0")

(iconserver "1")

(name "Art and Literature Hoedown")

(nsid "33853651696@N01")

(photos "2")

(privacy "3")))

(group

((admin "1")

(iconserver "1")

(name "FlickrIdeas")

(nsid "34427465446@N01")

(photos "20")

(privacy "3")))

(group

((admin "0")

(iconserver "1")

(name "GNEverybody")

(nsid "34427465497@N01")

(photos "4")

(privacy "3")))))

Explanation: The <code>privacy</code> attribute is 1 for private groups, 2 for invite-only public groups and 3 for open public groups.

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.pools.getGroups

API Explorer: flickr.groups.pools.getGroups

(flickr.groups.pools.getPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:group_id group_id
	[	#:tags tags
		#:user_id user_id
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

group_id : string?

tags : (or/c #f string?) = #f

user_id : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of pool photos for a given group, based on the permissions of the group and the user logged in (if any).

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
group_id – The id of the group who’s pool you which to get the photo list for.
tags – A tag to filter the pool with. At the moment only one tag at a time is supported.
user_id – The nsid of a user. Specifiying this parameter will retrieve for you only those photos that the user has contributed to the group pool.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photos

((page "1") (pages "1") (perpage "1") (total "1"))

(photo

((dateadded "1089918707")

(id "2645")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "12037949754@N01")

(ownername "Bees / ?")

(secret "a9f4a06091")

(server "2")

(title "36679_o")))))

Error codes:

1 – Group not found: The group id passed was not a valid group id.
2 – You don’t have permission to view this pool: The logged in user (if any) does not have permission to view the pool for this group.
3 – Unknown user: The user specified by user_id does not exist.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.pools.getPhotos

API Explorer: flickr.groups.pools.getPhotos

(flickr.groups.pools.remove	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:group_id group_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

group_id : string?

Remove a photo from a group pool.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – 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.
group_id – The NSID of the group who’s pool the photo is to removed from.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Group not found: The group_id passed did not refer to a valid group.
2 – Photo not in pool: The photo_id passed was not a valid id of a photo in the group pool.
3 – Insufficient permission to remove photo: 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.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.groups.pools.remove

API Explorer: flickr.groups.pools.remove

(flickr.groups.search	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:text text
	[	#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

text : string?

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Search for groups. 18+ groups will only be returned for authenticated calls where the authenticated user is over 18.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
text – The text to search for.
per_page – Number of groups to return per page. If this argument is ommited, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is ommited, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((groups

((page "1") (pages "14") (perpage "5") (total "67"))

(group ((eighteenplus "0") (name "Frito's Test Group") (nsid "3000@N02")))

(group ((eighteenplus "0") (name "Free for All") (nsid "32825757@N00")))

(group ((eighteenplus "0") (name "joly's mothers") (nsid "33335981560@N01")))

(group

((eighteenplus "0") (name "Wintermute tower") (nsid "33853651681@N01")))

(group

((eighteenplus "0")

(name "Art and Literature Hoedown")

(nsid "33853651696@N01")))))

Error codes:

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

Flickr API: flickr.groups.search

API Explorer: flickr.groups.search

(flickr.interestingness.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:date date
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

date : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns the list of interesting photos for the most recent day or a user-specified date.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
date – A specific date, formatted as YYYY-MM-DD, to return interesting photos for.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Error codes:

1 – Not a valid date string.: The date string passed did not validate. All dates must be formatted : YYYY-MM-DD
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.interestingness.getList

API Explorer: flickr.interestingness.getList

(flickr.machinetags.getNamespaces	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:predicate predicate
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

predicate : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return a list of unique namespaces, optionally limited by a given predicate, in alphabetical order.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
predicate – Limit the list of namespaces returned to those that have the following predicate.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

"MALFORMED RESPONSE"

Explanation: "Usage" gives you roughly how popular a machine tags, while "predicates" is the count of distinct predicates a namespace has.

Error codes:

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

Flickr API: flickr.machinetags.getNamespaces

API Explorer: flickr.machinetags.getNamespaces

(flickr.machinetags.getPairs	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:namespace namespace
		#:predicate predicate
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

namespace : (or/c #f string?) = #f

predicate : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return a list of unique namespace and predicate pairs, optionally limited by predicate or namespace, in alphabetical order.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
namespace – Limit the list of pairs returned to those that have the following namespace.
predicate – Limit the list of pairs returned to those that have the following predicate.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

"MALFORMED RESPONSE"

Error codes:

1 – Not a valid namespace: Missing or invalid namespace argument.
2 – Not a valid predicate: Missing or invalid predicate argument.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.machinetags.getPairs

API Explorer: flickr.machinetags.getPairs

(flickr.machinetags.getPredicates	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:namespace namespace
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

namespace : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return a list of unique predicates, optionally limited by a given namespace.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
namespace – Limit the list of predicates returned to those that have the following namespace.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((predicates

((page "1") (pages "1") (perpage "500") (total "3"))

(predicate ((namespaces "1") (usage "20")) "elbow")

(predicate ((namespaces "2") (usage "52")) "face")

(predicate ((namespaces "1") (usage "10")) "hand")))

Error codes:

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

Flickr API: flickr.machinetags.getPredicates

API Explorer: flickr.machinetags.getPredicates

(flickr.machinetags.getRecentValues	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:namespace namespace
		#:predicate predicate
		#:added_since added_since])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

namespace : (or/c #f string?) = #f

predicate : (or/c #f string?) = #f

added_since : (or/c #f string?) = #f

Fetch recently used (or created) machine tags values.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
namespace – A namespace that all values should be restricted to.
predicate – A predicate that all values should be restricted to.
added_since – Only return machine tags values that have been added since this timestamp, in epoch seconds.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((values

((namespace "taxonomy")

(page "1")

(pages "1")

(perpage "500")

(predicate "common")

(total "500"))

(value

((first_added "1244232796")

(last_added "1244232796")

(namespace "taxonomy")

(predicate "common")

(usage "4"))

"maui chaff flower")))

Error codes:

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

Flickr API: flickr.machinetags.getRecentValues

API Explorer: flickr.machinetags.getRecentValues

(flickr.machinetags.getValues	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:namespace namespace
		#:predicate predicate
	[	#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

namespace : string?

predicate : string?

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return a list of unique values for a namespace and predicate.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
namespace – The namespace that all values should be restricted to.
predicate – The predicate that all values should be restricted to.
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((values

((namespace "upcoming")

(page "1")

(pages "1")

(perpage "500")

(predicate "event")

(total "3"))

(value ((usage "3")) "123")

(value ((usage "1")) "456")

(value ((usage "147")) "789")))

Error codes:

1 – Not a valid namespace: Missing or invalid namespace argument.
2 – Not a valid predicate: Missing or invalid predicate argument.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.machinetags.getValues

API Explorer: flickr.machinetags.getValues

(flickr.panda.getList	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

Return a list of <a href="http://www.flickr.com/explore/panda">Flickr pandas</a>, from whom you can request photos using the <a href="/services/api/flickr.panda.getPhotos.htm">flickr.panda.getPhotos</a> API method.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((pandas

()

(panda () "ling ling")

(panda () "hsing hsing")

(panda () "wang wang")))

Error codes:

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

Flickr API: flickr.panda.getList

API Explorer: flickr.panda.getList

(flickr.panda.getPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:panda_name panda_name
	[	#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

panda_name : string?

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Ask the <a href="http://www.flickr.com/explore/panda">Flickr Pandas</a> for a list of recent public (and "safe") photos.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
panda_name – The name of the panda to ask for photos from. There are currently three pandas named: <ul><li><a href="http://flickr.com/photos/ucumari/126073203/">ling ling</a></li><li><a href="http://flickr.com/photos/lynnehicks/136407353">hsing hsing</a></li><li><a href="http://flickr.com/photos/perfectpandas/1597067182/">wang wang</a></li></ul> You can fetch a list of all the current pandas using the <a href="/services/api/flickr.panda.getList.html">flickr.panda.getList</a> API method.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photos

((interval "60000")

(lastupdate "1235765058272")

(panda "ling ling")

(total "120"))

(photo

((farm "4")

(id "3313428913")

(owner "72442527@N00")

(ownername "Pat Ulrich")

(secret "2cd3cb44cb")

(server "3609")

(title "Shorebirds at Pillar Point")))

(photo

((farm "4")

(id "3313713993")

(owner "10459691@N05")

(ownername "Sven Ericsson")

(secret "3f7f51500f")

(server "3382")

(title "Battle of the sky")))))

Explanation: 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.

Error codes:

1 – Required parameter missing.: One or more required parameters was not included with your request.
2 – Unknown panda: You requested a panda we haven’t met yet.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.panda.getPhotos

API Explorer: flickr.panda.getPhotos

(flickr.people.findByEmail	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:find_email find_email)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

find_email : string?

Return a user’s NSID, given their email address

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
find_email – The email address of the user to find (may be primary or secondary).

Authentication:

This method does not need login.

This method does not need signing.

Response:

((user ((nsid "12037949632@N01")) (username () "Stewart")))

Error codes:

1 – User not found: No user with the supplied email address was found.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.people.findByEmail

API Explorer: flickr.people.findByEmail

(flickr.people.findByUsername	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:username username)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

username : string?

Return a user’s NSID, given their username.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
username – The username of the user to lookup.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((user ((nsid "12037949632@N01")) (username () "Stewart")))

Error codes:

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

Flickr API: flickr.people.findByUsername

API Explorer: flickr.people.findByUsername

(flickr.people.getInfo	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

Get information about a user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to fetch information about.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((person

((iconfarm "1") (iconserver "122") (ispro "0") (nsid "12037949754@N01"))

(username () "bees")

(realname () "Cal Henderson")

(mbox_sha1sum () "eea6cd28e3d0003ab51b0058a684d94980b727ac")

(location () "Vancouver, Canada")

(photosurl () "http://www.flickr.com/photos/bees/")

(profileurl () "http://www.flickr.com/people/bees/")

(photos

()

(firstdate () "1071510391")

(firstdatetaken () "1900-09-02 09:11:24")

(count () "449"))))

Explanation: The <code>firstdate</code> element contains the unix timestamp of the first photo uploaded by the user. The <code>firstdatetaken</code> element contains the mysql datetime of the first photo taken by the user.The <code>iconserver</code> element is used to build the url to the users’ buddyicon - for more information please read the <a href="/services/api/misc.buddyicons.html">buddyicon guide</a>. If the API call is authenticated contact information will also be returned as attributes on the person element. <code>contact</code>, <code>friend</code>, and <code>family</code> are boolean flags describing the relationship between the <a href="/services/api/auth.spec.html">authenticated</a> user, and the person currently being inspected. <code>revcontact</code>, <code>revfriend</code>, and <code>revfamily</code> is the reciprocal relationship.

Error codes:

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

Flickr API: flickr.people.getInfo

API Explorer: flickr.people.getInfo

(flickr.people.getPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:safe_search safe_search
		#:min_upload_date min_upload_date
		#:max_upload_date max_upload_date
		#:min_taken_date min_taken_date
		#:max_taken_date max_taken_date
		#:content_type content_type
		#:privacy_filter privacy_filter
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

safe_search : (or/c #f string?) = #f

min_upload_date : (or/c #f string?) = #f

max_upload_date : (or/c #f string?) = #f

min_taken_date : (or/c #f string?) = #f

max_taken_date : (or/c #f string?) = #f

content_type : (or/c #f string?) = #f

privacy_filter : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

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 <a href="/services/api/flickr.people.getPublicPhotos.html">flickr.people.getPublicPhotos</a>.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user who’s photos to return. A value of "me" will return the calling user’s photos.
safe_search – Safe search setting: <ul><li>1 for safe.</li><li>2 for moderate.</li><li>3 for restricted.</li></ul> (Please note: Un-authed calls can only see Safe content.)
min_upload_date – 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.
max_upload_date – 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.
min_taken_date – 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.
max_taken_date – 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.
content_type – Content Type setting: <ul><li>1 for photos only.</li><li>2 for screenshots only.</li><li>3 for ’other’ only.</li><li>4 for photos and screenshots.</li><li>5 for screenshots and ’other’.</li><li>6 for photos and ’other’.</li><li>7 for photos, screenshots, and ’other’ (all).</li></ul>
privacy_filter – Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are: <ul><li>1 public photos</li><li>2 private photos visible to friends</li><li>3 private photos visible to family</li><li>4 private photos visible to friends & family</li><li>5 completely private photos</li></ul>
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Required arguments missing:
2 – Unknown user: A user_id was passed which did not match a valid flickr user.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.people.getPhotos

API Explorer: flickr.people.getPhotos

(flickr.people.getPhotosOf	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Returns a list of photos containing a particular Flickr member.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user who’s photo to search. A value of "me" will search against the calling user’s photos for authenticated calls.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photos

((has_next_page "1") (page "2") (perpage "10"))

(photo

((id "2636")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "47058503995@N01")

(secret "a123456")

(server "2")

(title "test_04")))

(photo

((id "2635")

(isfamily "1")

(isfriend "1")

(ispublic "0")

(owner "47058503995@N01")

(secret "b123456")

(server "2")

(title "test_03")))

(photo

((id "2633")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "47058503995@N01")

(secret "c123456")

(server "2")

(title "test_01")))

(photo

((id "2610")

(isfamily "0")

(isfriend "0")

(ispublic "1")

(owner "12037949754@N01")

(secret "d123456")

(server "2")

(title "00_tall")))))

Explanation: This method returns a variant of the standard photo list xml.For queries about a member other than the currently authenticated one, pagination data ("total" and "pages" attributes) will not be available.Instead, the <photos> element will contain a boolean value ’has_next_page’ which will tell you whether or not there are more photos to fetch.

Error codes:

1 – User not found.: A user_id was passed which did not match a valid flickr user.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.people.getPhotosOf

API Explorer: flickr.people.getPhotosOf

(flickr.people.getPublicGroups	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

Returns the list of public groups a user is a member of.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to fetch groups for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((groups

()

(group

((admin "0")

(eighteenplus "0")

(name "FlickrCentral")

(nsid "34427469792@N01")))

(group

((admin "1")

(eighteenplus "0")

(name "Cal's Test Group")

(nsid "37114057624@N01")))

(group

((admin "1")

(eighteenplus "1")

(name "18+ Group")

(nsid "34955637532@N01")))))

Explanation: The <code>admin</code> attribute indicates whether the user is an administrator of the group. The <code>eighteenplus</code> attribute indicates if the group is visible to members over 18 only.

Error codes:

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

Flickr API: flickr.people.getPublicGroups

API Explorer: flickr.people.getPublicGroups

(flickr.people.getPublicPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:safe_search safe_search
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

safe_search : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Get a list of public photos for the given user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user who’s photos to return.
safe_search – Safe search setting: <ul><li>1 for safe.</li><li>2 for moderate.</li><li>3 for restricted.</li></ul> (Please note: Un-authed calls can only see Safe content.)
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method does not need login.

This method does not need signing.

Error codes:

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

Flickr API: flickr.people.getPublicPhotos

API Explorer: flickr.people.getPublicPhotos

(flickr.people.getUploadStatus	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

Returns information for the calling user related to photo uploads.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.

Authentication:

This method needs login.

This method needs signing.

Response:

((user

((id "12037949754@N01") (ispro "1"))

(username () "Bees")

(bandwidth

((maxbytes "2147483648")

(maxkb "2097152")

(remainingbytes "2147099924")

(remainingkb "2096777")

(usedbytes "383724")

(usedkb "374")))

(filesize ((maxbytes "10485760") (maxkb "10240")))

(sets ((created "27") (remaining "lots")))

(videos ((remaining "lots") (uploaded "5")))))

Explanation: 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.Bandwidth is specified in bytes/kb per month.All accounts display "lots" for the number of remaining sets, but remains in the response for backwards compatibility.Pro accounts display "lots" for the number of remaining videos, while free users will display 0, 1, or 2.

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.people.getUploadStatus

API Explorer: flickr.people.getUploadStatus

(flickr.photos.addTags	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:tags tags)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

tags : string?

Add tags to a photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to add tags to.
tags – The tags to add to the photo.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: 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.
2 – Maximum number of tags reached: 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.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.addTags

API Explorer: flickr.photos.addTags

(flickr.photos.comments.addComment
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:comment_text comment_text)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

comment_text : string?

Add comment to a photo as the currently authenticated user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to add a comment to.
comment_text – Text of the comment

Authentication:

This method needs login.

This method needs signing.

Response:

((comment ((id "97777-72057594037941949-72057594037942602"))))

Error codes:

1 – Photo not found.: The photo id passed was not a valid photo id
8 – Blank comment.: Comment text can not be blank
9 – User is posting comments too fast.: The user has reached the limit for number of comments posted during a specific time period. Wait a bit and try again.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.comments.addComment

API Explorer: flickr.photos.comments.addComment

(flickr.photos.comments.deleteComment	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:comment_id comment_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

comment_id : string?

Delete a comment as the currently authenticated user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
comment_id – The id of the comment to edit.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found.: The requested comment is against a photo which no longer exists.
2 – Comment not found.: The comment id passed was not a valid comment id
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.comments.deleteComment

API Explorer: flickr.photos.comments.deleteComment

(flickr.photos.comments.editComment
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:comment_id comment_id
		#:comment_text comment_text)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

comment_id : string?

comment_text : string?

Edit the text of a comment as the currently authenticated user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
comment_id – The id of the comment to edit.
comment_text – Update the comment to this text.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found.: The requested comment is against a photo which no longer exists.
2 – Comment not found.: The comment id passed was not a valid comment id
8 – Blank comment.: Comment text can not be blank
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.comments.editComment

API Explorer: flickr.photos.comments.editComment

(flickr.photos.comments.getList
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
	[	#:min_comment_date min_comment_date
		#:max_comment_date max_comment_date])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

min_comment_date : (or/c #f string?) = #f

max_comment_date : (or/c #f string?) = #f

Returns the comments for a photo

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to fetch comments for.
min_comment_date – Minimum date that a a comment was added. The date should be in the form of a unix timestamp.
max_comment_date – Maximum date that a comment was added. The date should be in the form of a unix timestamp.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((comments

((photo_id "109722179"))

(comment

((author "35468159852@N01")

(authorname "Rev Dan Catt")

(datecreate "1141841470")

(id "6065-109722179-72057594077818641")

(permalink

"http://www.flickr.com/photos/straup/109722179/#comment72057594077818641"))

"Umm, I'm not sure, can I get back to you on that one?")))

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.comments.getList

API Explorer: flickr.photos.comments.getList

(flickr.photos.comments.getRecentForContacts
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:date_lastcomment date_lastcomment
		#:contacts_filter contacts_filter
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

date_lastcomment : (or/c #f string?) = #f

contacts_filter : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return the list of photos belonging to your contacts that have been commented on recently.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
date_lastcomment – Limits the resultset to photos that have been commented on since this date. The date should be in the form of a Unix timestamp. The default, and maximum, offset is (1) hour.
contacts_filter – A comma-separated list of contact NSIDs to limit the scope of the query to.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.comments.getRecentForContacts

API Explorer: flickr.photos.comments.getRecentForContacts

(flickr.photos.delete	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Delete a photo from flickr.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to delete.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id was not the id of a photo belonging to the calling user.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.delete

API Explorer: flickr.photos.delete

(flickr.photos.geo.batchCorrectLocation
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:lat lat
		#:lon lon
		#:accuracy accuracy
	[	#:place_id place_id
		#:woe_id woe_id])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

lat : string?

lon : string?

accuracy : string?

place_id : (or/c #f string?) = #f

woe_id : (or/c #f string?) = #f

Correct the places hierarchy for all the photos for a user at a given latitude, longitude and accuracy. Batch corrections are processed in a delayed queue so it may take a few minutes before the changes are reflected in a user’s photos.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
lat – The latitude of the photos to be update whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.
lon – The longitude of the photos to be updated whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated.
accuracy – 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.
place_id – A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)
woe_id – A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Required arguments missing: Some or all of the required arguments were not supplied.
2 – Not a valid latitude: The latitude argument failed validation.
3 – Not a valid longitude: The longitude argument failed validation.
4 – Not a valid accuracy: The accuracy argument failed validation.
5 – Not a valid Places ID: An invalid Places (or WOE) ID was passed with the API call.
6 – No photos geotagged at that location: There were no geotagged photos found for the authed user at the supplied latitude, longitude and accuracy.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.batchCorrectLocation

API Explorer: flickr.photos.geo.batchCorrectLocation

(flickr.photos.geo.correctLocation	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
	[	#:place_id place_id
		#:woe_id woe_id])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

place_id : (or/c #f string?) = #f

woe_id : (or/c #f string?) = #f

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The ID of the photo whose WOE location is being corrected.
place_id – A Flickr Places ID. (While optional, you must pass either a valid Places ID or a WOE ID.)
woe_id – A Where On Earth (WOE) ID. (While optional, you must pass either a valid Places ID or a WOE ID.)

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – User has not configured default viewing settings for location data.: 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 <a href="http://www.flickr.com/account/geo/privacy/">http://www.flickr.com/account/geo/privacy/</a>
2 – Missing place ID: No place ID was passed to the method
3 – Not a valid place ID: The place ID passed to the method could not be identified
4 – Server error correcting location.: There was an error trying to correct the location.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.correctLocation

API Explorer: flickr.photos.geo.correctLocation

(flickr.photos.geo.getLocation	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Get the geo data (latitude and longitude and the accuracy level) for a photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo you want to retrieve location data for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photo

((id "123"))

(location ((accuracy "6") (latitude "-17.685895") (longitude "-63.36914")))))

Error codes:

1 – Photo not found.: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Photo has no location information.: The photo requested has no location data or is not viewable by the calling user.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.getLocation

API Explorer: flickr.photos.geo.getLocation

(flickr.photos.geo.getPerms	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Get permissions for who may view geo data for a photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to get permissions for.

Authentication:

This method needs login.

This method needs signing.

Response:

((perms

((id "10592") (iscontact "0") (isfamily "1") (isfriend "0") (ispublic "0"))))

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Photo has no location information: The photo requested has no location data or is not viewable by the calling user.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.getPerms

API Explorer: flickr.photos.geo.getPerms

(flickr.photos.geo.photosForLocation	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:lat lat
		#:lon lon
	[	#:accuracy accuracy
		#:extras extras
		#:per_page per_page
		#:page page])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

lat : string?

lon : string?

accuracy : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

per_page : (or/c #f string?) = #f

page : (or/c #f string?) = #f

Return a list of photos for a user at a specific latitude, longitude and accuracy

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
lat – The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.
lon – The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated.
accuracy – 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.
extras – A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: <code>description</code>, <code>license</code>, <code>date_upload</code>, <code>date_taken</code>, <code>owner_name</code>, <code>icon_server</code>, <code>original_format</code>, <code>last_update</code>, <code>geo</code>, <code>tags</code>, <code>machine_tags</code>, <code>o_dims</code>, <code>views</code>, <code>media</code>, <code>path_alias</code>, <code>url_sq</code>, <code>url_t</code>, <code>url_s</code>, <code>url_m</code>, <code>url_o</code>
per_page – Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.
page – The page of results to return. If this argument is omitted, it defaults to 1.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Required arguments missing: One or more required arguments was missing from the method call.
2 – Not a valid latitude: The latitude argument failed validation.
3 – Not a valid longitude: The longitude argument failed validation.
4 – Not a valid accuracy: The accuracy argument failed validation.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.photosForLocation

API Explorer: flickr.photos.geo.photosForLocation

(flickr.photos.geo.removeLocation	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Removes the geo data associated with a photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo you want to remove location data from.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Photo has no location information: The specified photo has not been geotagged - there is nothing to remove.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.removeLocation

API Explorer: flickr.photos.geo.removeLocation

(flickr.photos.geo.setContext	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:context context)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

context : string?

Indicate the state of a photo’s geotagginess beyond latitude and longitude. Note : photos passed to this method must already be geotagged (using the <q>flickr.photos.geo.setLocation</q> method).

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to set context data for.
context – 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". The current list of context IDs is : <ul><li>0, not defined.</li><li>1, indoors.</li><li>2, outdoors.</li></ul>

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Not a valid context: The context ID passed to the method is invalid.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.setContext

API Explorer: flickr.photos.geo.setContext

(flickr.photos.geo.setLocation	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
		#:lat lat
		#:lon lon
	[	#:accuracy accuracy
		#:context context])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

lat : string?

lon : string?

accuracy : (or/c #f string?) = #f

context : (or/c #f string?) = #f

Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo. 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 <a href="http://www.flickr.com/account/geo/privacy/">http://www.flickr.com/account/geo/privacy/</a>. If a user has not set this preference, the API method will return an error.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to set location data for.
lat – The latitude whose valid range is -90 to 90. Anything more than 6 decimal places will be truncated.
lon – The longitude whose valid range is -180 to 180. Anything more than 6 decimal places will be truncated.
accuracy – 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.
context – 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". The current list of context IDs is : <ul><li>0, not defined.</li><li>1, indoors.</li><li>2, outdoors.</li></ul> The default context for geotagged photos is 0, or "not defined"

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Required arguments missing.: Some or all of the required arguments were not supplied.
3 – Not a valid latitude.: The latitude argument failed validation.
4 – Not a valid longitude.: The longitude argument failed validation.
5 – Not a valid accuracy.: The accuracy argument failed validation.
6 – Server error.: There was an unexpected problem setting location information to the photo.
7 – User has not configured default viewing settings for location data.: 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 <a href="http://www.flickr.com/account/geo/privacy/">http://www.flickr.com/account/geo/privacy/</a>
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.setLocation

API Explorer: flickr.photos.geo.setLocation

(flickr.photos.geo.setPerms	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:is_public is_public
		#:is_contact is_contact
		#:is_friend is_friend
		#:is_family is_family
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

is_public : string?

is_contact : string?

is_friend : string?

is_family : string?

photo_id : string?

Set the permission for who may view the geo data associated with a photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
is_public – 1 to set viewing permissions for the photo’s location data to public, 0 to set it to private.
is_contact – 1 to set viewing permissions for the photo’s location data to contacts, 0 to set it to private.
is_friend – 1 to set viewing permissions for the photo’s location data to friends, 0 to set it to private.
is_family – 1 to set viewing permissions for the photo’s location data to family, 0 to set it to private.
photo_id – The id of the photo to get permissions for.

Authentication:

This method needs login.

This method needs signing.

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Photo has no location information: The photo requested has no location data or is not viewable by the calling user.
3 – Required arguments missing.: Some or all of the required arguments were not supplied.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.geo.setPerms

API Explorer: flickr.photos.geo.setPerms

(flickr.photos.getAllContexts	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Returns all visible sets and pools the photo belongs to.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The photo to return information for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((set ((id "392") (title "记忆群组"))))

Error codes:

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

Flickr API: flickr.photos.getAllContexts

API Explorer: flickr.photos.getAllContexts

(flickr.photos.getContactsPhotos	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:count count
		#:just_friends just_friends
		#:single_photo single_photo
		#:include_self include_self
		#:extras extras])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

count : (or/c #f string?) = #f

just_friends : (or/c #f string?) = #f

single_photo : (or/c #f string?) = #f

include_self : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

Fetch a list of recent photos from the calling users’ contacts.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
count – Number of photos to return. Defaults to 10, maximum 50. This is only used if <code>single_photo</code> is not passed.
just_friends – set as 1 to only show photos from friends and family (excluding regular contacts).
single_photo – Only fetch one photo (the latest) per contact, instead of all photos in chronological order.
include_self – Set to 1 to include photos from the calling user.
extras – 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 <a href="/services/api/flickr.photos.search.html">flickr.photos.search</a>.

Authentication:

This method needs login.

This method needs signing.

Response:

"MALFORMED RESPONSE"

Error codes:

96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.getContactsPhotos

API Explorer: flickr.photos.getContactsPhotos

(flickr.photos.getContactsPublicPhotos
	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:user_id user_id
	[	#:count count
		#:just_friends just_friends
		#:single_photo single_photo
		#:include_self include_self
		#:extras extras])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

user_id : string?

count : (or/c #f string?) = #f

just_friends : (or/c #f string?) = #f

single_photo : (or/c #f string?) = #f

include_self : (or/c #f string?) = #f

extras : (or/c #f string?) = #f

Fetch a list of recent public photos from a users’ contacts.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
user_id – The NSID of the user to fetch photos for.
count – Number of photos to return. Defaults to 10, maximum 50. This is only used if <code>single_photo</code> is not passed.
just_friends – set as 1 to only show photos from friends and family (excluding regular contacts).
single_photo – Only fetch one photo (the latest) per contact, instead of all photos in chronological order.
include_self – Set to 1 to include photos from the user specified by user_id.
extras – 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.

Authentication:

This method does not need login.

This method does not need signing.

Response:

"MALFORMED RESPONSE"

Error codes:

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

Flickr API: flickr.photos.getContactsPublicPhotos

API Explorer: flickr.photos.getContactsPublicPhotos

(flickr.photos.getContext	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id)

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

Returns next and previous photos for a photo in a photostream.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to fetch the context for.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((prevphoto

((id "2980")

(secret "973da1e709")

(title "boo!")

(url "/photos/bees/2980/"))))

Explanation: When either the previous of next photo is unavailable, the element is still returned, but contains <code>id="0"</code>

Error codes:

1 – Photo not found: 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.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.getContext

API Explorer: flickr.photos.getContext

(flickr.photos.getCounts	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key
		#:dates dates
		#:taken_dates taken_dates])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

dates : (or/c #f string?) = #f

taken_dates : (or/c #f string?) = #f

Gets a list of photo counts for the given date ranges for the calling user.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
dates – A comma delimited list of unix timestamps, denoting the periods to return counts for. They should be specified smallest first.
taken_dates – A comma delimited list of mysql datetimes, denoting the periods to return counts for. They should be specified smallest first.

Authentication:

This method needs login.

This method needs signing.

Response:

((photocounts

()

(photocount ((count "4") (fromdate "1093566950") (todate "1093653350")))

(photocount ((count "0") (fromdate "1093653350") (todate "1093739750")))

(photocount ((count "0") (fromdate "1093739750") (todate "1093826150")))

(photocount ((count "2") (fromdate "1093826150") (todate "1093912550")))

(photocount ((count "0") (fromdate "1093912550") (todate "1093998950")))

(photocount ((count "0") (fromdate "1093998950") (todate "1094085350")))

(photocount ((count "0") (fromdate "1094085350") (todate "1094171750")))))

Error codes:

1 – No dates specified: Neither dates nor taken_dates were specified.
96 – Invalid signature: The passed signature was invalid.
97 – Missing signature: The call required signing but no signature was sent.
98 – Login failed / Invalid auth token: The login details or auth token passed were invalid.
99 – User not logged in / Insufficient permissions: The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested response format was not found.
112 – Method "xxx" not found: The requested method was not found.
114 – Invalid SOAP envelope: The SOAP envelope send in the request could not be parsed.
115 – Invalid XML-RPC Method Call: The XML-RPC request document could not be parsed.
116 – Bad URL found: One or more arguments contained a URL that has been used for abuse on Flickr.

Flickr API: flickr.photos.getCounts

API Explorer: flickr.photos.getCounts

(flickr.photos.getExif	[	#:api_sig api_sig
		#:auth_token auth_token
		#:api_key api_key]
		#:photo_id photo_id
	[	#:secret secret])

→ (listof xexpr?)

api_sig : (or/c #f string?) = #f

auth_token : (or/c #f string?) = #f

api_key : string? = (current-api-key)

photo_id : string?

secret : (or/c #f string?) = #f

Retrieves a list of EXIF/TIFF/GPS tags for a given photo. The calling user must have permission to view the photo.

api_key – Your API application key. <a href="/services/api/misc.api_keys.html">See here</a> for more details.
photo_id – The id of the photo to fetch information for.
secret – 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.

Authentication:

This method does not need login.

This method does not need signing.

Response:

((photo

((id "4424") (secret "06b8e43bc7") (server "2"))

(exif

((label "Manufacturer") (tag "271") (tagspace "TIFF") (tagspaceid "1"))

(raw () "Canon"))

(exif

((label "Aperture") (tag "33437") (tagspace "EXIF") (tagspaceid "0"))

(raw () "90/10")

(clean () "f/9"))

(exif

((label "Longitude") (tag "4") (tagspace "GPS") (tagspaceid "3"))

(raw () "64/1, 42/1, 4414/100")

(clean () "64° 42' 44.14\""))))

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

Error codes:

1 – Photo not found: The photo id was either invalid or was for a photo not viewable by the calling user.
2 – Permission denied: The owner of the photo does not want to share EXIF data.
100 – Invalid API Key: The API key passed was not valid or has expired.
105 – Service currently unavailable: The requested service is temporarily unavailable.
111 – Format "xxx" not found: The requested r