username: password: remember me
Create a new GroupMe! account
GroupMe!
GroupMe! Search API Documentation

Search API

This GroupMe! API enables client applications to search for resources in GroupMe! and to retrieve the search result as an XML-formatted list. The endpoint of this API is http://groupme.org/GroupMe/api.do


API Methods

Parameter used to specify the method that should be executed: method


groupme.search


The search methods allow to search for GroupMe! groups and resources. We provide the following search methods:


  • groupme.search - Performs a search for resources and groups.
  • groupme.search.groups - Performs a search for groups only.
  • groupme.search.resources - Performs a search for resources only.

Parameters and options for GroupMe! search methods:


  • tag - Mandatory parameter, which allows to specify tags/keywords that should be used as search query. For search methods the specification of at least one tag is mandatory.
  • conjunction - Optional parameter, which enables you to specify how multiple tags are connected. Allowed values: or and and. If no conjunction is given then the tags are used as OR-connected query.
  • offset - Optional parameter, which allows to specify how many results of the top k results should be skipped (not returned).
  • limit - Optional parameter, which allows to limit the number of returned results.
  • output - Optional parameter, which allows to specify which output format should be used. Allowed values: xml. Standard output: xml.

Examples:


  • http://groupme.org/GroupMe/api.do?method=groupme.search&tag=web&tag=iswc - Returns GroupMe! groups and resources, which are related to web or iswc. XML is used as standard output format so that the result looks as follows:
    
<?xml version="1.0" encoding="ISO-8859-1"?>

<result query="web, iswc" time="Wed May 07 19:57:14 CEST 2008">

	<resource rank="1" uri="http://groupme.org/GroupMe/resource/111" weburl="http://iswc2007.semanticweb.org/rss/news.rss" 
	                      name="ISWC2007 + ASWC2007" 
	                      description="The 6th International Semantic Web Conference and the 2nd Asian Semantic Web 
	                      Conference, 2007" type="rss">
		<hasTag tag="news"/>	
		<hasTag tag="semantic web"/>	
		<hasTag tag="iswc"/>	
	</resource>
	
	<resource rank="2" uri="http://groupme.org/GroupMe/resource/112" 
	                      weburl="http://iswc2007.semanticweb.org/img/ISWC_Top.jpg" 
	                      name="ISWC/ASWC 07 Logo" description="Logo of the ISWC/ASWC 07" type="image">
		<hasTag tag="iswc"/>	
		<hasTag tag="2007"/>	
		<hasTag tag="aswc"/>	
	</resource>

	<resource rank="3" uri="http://groupme.org/GroupMe/group/104" name="ISWC 2007" 
	             description="Infos about the International Semantic Web Conference 2007 in Korea" type="group">
		<hasTag tag="iswc"/>	
		<hasTag tag="web"/>	
		<hasTag tag="semantic web"/>	
		<hasTag tag="aswc"/>	
		<hasTag tag="eslab"/>	
		<hasTag tag="2007"/>	

		<hasResource uri="http://groupme.org/GroupMe/resource/105" 
		                weburl="http://iswc2007.semanticweb.org/img/photo/Barney_Pell.jpg" 
		                name="Barney Pell" 
		                type="image"/>	
		<hasResource uri="http://groupme.org/GroupMe/resource/106" 
		                weburl="http://iswc2007.semanticweb.org/img/photo/chris_welty.jpg" 
		                name="Chris Welty" 
		                type="image"/>	
		<hasResource uri="http://groupme.org/GroupMe/resource/107" 
		                weburl="http://iswc2007.semanticweb.org/" 
		                name="iswc 2007" 
		                type="website"/>	
		<hasResource uri="http://groupme.org/GroupMe/resource/108" 
		                weburl="http://static.flickr.com/90/243820601_ae4014f569.jpg" 
		                name="Gwangalli Beach" 
		                type="image"/>	
		<hasResource uri="http://groupme.org/GroupMe/resource/110" 
		                weburl="http://static.flickr.com/137/406287530_b0f1340fb1.jpg" 
		                name="busy Busan" 
		                type="image"/>	
		<hasResource uri="http://groupme.org/GroupMe/resource/111" 
		                weburl="http://iswc2007.semanticweb.org/rss/news.rss" 
		                name="ISWC2007 + ASWC2007" 
		                type="rss"/>	
	</resource>
</result>
  • http://groupme.org/GroupMe/api.do?method=groupme.search&tag=web&tag=iswc - Click on the link to see the result :)