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


This method requires authentication with 'read' permission.


api_key (Required)
Your API application key. See here for more details.
page (Optional)
The page of results to return. If this argument is omitted, it defaults to 1.
per_page (Optional)
Number of groups to return per page. If this argument is omitted, it defaults to 400. The maximum allowed value is 400.

Example Response

<groups page="1" pages="1" per_page="400" total="3">
  <group nsid="33853651696@N01" name="Art and Literature Hoedown" admin="0" privacy="3" photos="2" iconserver="1" />
  <group nsid="34427465446@N01" name="FlickrIdeas" admin="1" privacy="3" photos="20" iconserver="1" />
  <group nsid="34427465497@N01" name="GNEverybody" admin="0" privacy="3" photos="4" iconserver="1" />

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

Error Codes

95: SSL is required
SSL is required to access the Flickr API.
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.
106: Write operation failed
The requested operation failed due to a temporary issue.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
114: Invalid SOAP envelope
The SOAP envelope send in the request could not be parsed.
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
116: Bad URL found
One or more arguments contained a URL that has been used for abuse on Flickr.

API Explorer

API Explorer : flickr.groups.pools.getGroups