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

Export API

There are currently two export formats available: RDF and RSS. You can choose in which format the data should be exported by using the export-format parameter.

Further options are listed below:

Arguments

  • tag
    The tag parameter specifies the keyword the searched resource (or group) is tagged with.
    Multiple tags are possible, for example:
    ...export.do?tag=hannover&tag=rathaus
    By searching for a keyword, the parameter mode is required!

  • export-format (optional)
    Currently there are two export formats available. If no format is submitted, the data will be exported in RDF.
  • mode
    This parameter declares what should be exported. Exporting groups implies the export of resources in the respective group. However exporting resources only means the export of the keyword(s) tagged resources.
    • export-groups
    • export-resources

Example answers

The answer shown below in RSS:

                                            
  <channel>
    <title>search-result</title>
    <description />
    <dc:language>en</dc:language>
    <pubDate>Tue, 10 Jul 2007 23:20:23 CEST</pubDate>
    <item>
      <title>Hannover</title>
      <description>Sightseeing stuff in Hannover</description>
      <category>Hannover</category>
      <category>rathaus</category>
      <category>gärten</category>
    </item>
    <item>
      <title>Hannover</title>
      <description>Hannover ist eine wunderschöne Stadt.</description>   
      <category>Hannover</category>
    </item>
  </channel>

The answer shown below in RDF (truncated):

                                            
  <rdf:Description rdf:about="http://www.groupme.net/Resource#1173">
    <groupme:hasTag rdf:resource="http://www.groupme.net/Tag#6"/>
    <groupme:hasResource rdf:resource="http://www.groupme.net/Resource#1175"/>
    <groupme:hasResource rdf:resource="http://www.groupme.net/Resource#1174"/>
    <groupme:resourceURL rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
    </groupme:resourceURL>
    <dc:description rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
      Hannover ist eine wunderschöne Stadt.
    </dc:description>
    <dc:title rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
      Hannover
    </dc:title>
    <rdf:type rdf:resource="http://groupme.net/rdf/#Group"/>
  </rdf:Description>
  <rdf:Description rdf:about="http://www.groupme.net/Tag#6">
    <groupme:isCorrelatedTo rdf:nodeID="A2"/>
    <groupme:isCorrelatedTo rdf:nodeID="A1"/>
    <groupme:isCorrelatedTo rdf:nodeID="A0"/>
    <dc:description rdf:datatype="http://www.w3.org/2001/XMLSchema#string"/>
    <groupme:keyword rdf:datatype="http://www.w3.org/2001/XMLSchema#string">
      Hannover
    </groupme:keyword>
    <rdf:type rdf:resource="http://groupme.net/rdf/#Tag"/>
  </rdf:Description>
  ...

The client api is an easy way to use the possibilities of GroupMe! in your application. The example below show you how to get started. The Javadoc api can be found here.
To download the client api Jar file please click here.

Client example

The following example will show you how easy it is to use the GroupMe! api. Just create a collection of keywords the group (or resource) should be tagged with (line 1 - 3). You only have to call the corresponding method with these keywords (line 4) and receive a collection of groups (or resources). 

                                            
    // imports
    import org.groupme.action.GroupMeFactory;
    import org.groupme.model.Group;
    import org.groupme.model.Resource;
    ...

    // create a list of keywords the group(s) is (are) tagged with
(1) Collection<String> keywords = new ArrayList<String>();
(2) keywords.add("semantic web");
(3) keywords.add("Web 2.0");

    // get groups by these keywords
(4) Collection<Group> groupCollection = GroupMeFactory.getGroupsByTags(keywords); 

    // get the name and resources of the first group
(5) Group firstGroup = groupCollection.iterator.next();
(6) String groupName = firstGroup.getName();
(7) Collection<Resource> resourceCollection = firstGroup.getGroups();