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


This method does not require authentication.


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

Example Response

<groups page="1" pages="14" perpage="5" total="67">
  <group nsid="3000@N02" name="Frito's Test Group" eighteenplus="0" />
  <group nsid="32825757@N00" name="Free for All" eighteenplus="0" />
  <group nsid="33335981560@N01" name="joly's mothers" eighteenplus="0" />
  <group nsid="33853651681@N01" name="Wintermute tower" eighteenplus="0" />
  <group nsid="33853651696@N01" name="Art and Literature Hoedown" eighteenplus="0" />

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