account.getQuota album.create album.delete album.docs.add album.docs.getContext album.docs.getList album.docs.remove album.docs.setList album.edit album.get album.getFaves album.getList album.getVisitors album.orderList album.setPerms api.methods.get api.methods.getList auth.checkToken auth.getFrob auth.getToken doc.checkMD5 doc.comments.add doc.comments.delete doc.comments.edit doc.comments.get doc.comments.getList doc.comments.reply doc.delete doc.get doc.getContainers doc.getContext doc.getFaves doc.getList doc.getMedias doc.getPerms doc.getVisitors doc.notes.add doc.notes.delete doc.notes.edit doc.search doc.set doc.setLicense doc.setPerms doc.tags.add doc.tags.edit doc.tags.getList doc.tags.remove explore.docs.getPopular explore.docs.getRecent explore.docs.homepage faves.albums.add faves.albums.getList faves.albums.remove faves.docs.add faves.docs.getList faves.docs.remove group.docs.add group.docs.getContext group.docs.getList group.docs.remove group.get group.getList group.search network.autocomplete network.docs.getRecent network.getList tags.docs.getList tags.user.getList tags.user.getPopular test.echo test.hello upload.checkTickets upload.file upload.replace user.get

group.search / Live testing

Search for a group.

• This method call does not require authentication.
• This method does not require any particular permission.

URL

http://www.ipernity.com/api/group.search

Parameters

api_key	∗	Your api_key.
text		Search group titles and descriptions in fulltext. (Use +/- for boolean mode)
lang		The language code of the group title and description to fetch. If not specified, the calling user language or the browser language will be used by default.
sort		The order in which to sort returned groups: relevance: sort by fulltext relevance. (This is the default). created-desc: sort by creation date newest first. created-asc: sort by creation date oldest first.
per_page		The number of docs to return on each page. (Default is 20, maximum is 100)
page		The page of results to return.

∗ : this parameter is required.

Response

<groups page="1" total="5125" pages="256" per_page="20">
  <group group_id="125" title="Abarth lovers" 
         link="http://www.ipernity.com/group/acoolgroup"
         icon="http://u1.ipernity.com/p/00/01/125.jpg">
    <count members="125" docs="2563" topics="13"/>
    <dates created_at="1218038768" 
           last_doc_at="1218048563" last_topic_at="1218048231"/>
    <visibility ispublic="1" docs="1" topics="1"/>
  </group>
   <group group_id="126" title="Kitty Club" 
         link="http://www.ipernity.com/group/kitty"
         icon="http://u1.ipernity.com/p/00/01/126.jpg">
    <count members="1325" docs="25563" topics="636"/>
    <dates created_at="1218048748" 
           last_doc_at="1218348462" last_topic_at="1218044233"/>
    <visibility ispublic="1" docs="1" topics="1"/>
  </group>
  (...)
</groups>

Error codes

1	Search text query is empty	The required text parameter was ommited.
100	API Key is missing	Please add the api_key parameter to this request.
101	API Key is invalid	This API key is invalid or disabled.
102	Invalid format	The requested format is invalid. Valid formats are : json, xml, php.
103	Method not found	The requested method is invalid or missing.
104	Signature missing	The query signature is missing.
105	Signature is invalid	The query signature is invalid.
106	Token missing	User is not logged. The authentication token is missing.
107	Token invalid	The authentication token is invalid.
108	Account closed	The user account is closed or suspended.
109	Action blocked	This action is blocked because of a member or a group blocklist restriction
110	Insufficient permissions	Insufficient permissions for this method.
111	IP not allowed	The request came from a remote address not allowed by this application.
112	Application Quota Error	The application has reached its requests quota.
113	Client IP Quota Error	The client IP has reached a limit. Limits are based on requests per seconds, minutes, hours, ...
120	HTTP POST required	This API method must be called using HTTP POST.
121	Invalid SOAP envelope	The SOAP envelope could not be parsed.
122	Invalid XML-RPC envelope	The XML-RPC envelope could not be parsed.
500	Service error	Service general error.
501	Maintenance mode	Service under temporarily maintenance. Thank you for your kind understanding.
503	Service unavailable	The service is temporarily unavailable. Please try again in a few minutes.

Changelog

• 2008-12-01: Method created.

See also

• group.docs.add
• group.docs.getContext
• group.docs.getList
• group.docs.remove
• group.getList