Developers can plug the service into their own programs by using simple http requests.

This document and the APIs herein are subject to change at any time. Sorry, the API is still under development.


Send a HTTP GET or POST request to[METHOD]=[VALUE]. You will receive a response document with the tags we found in the text.



  • Example:!

Important Notice: The value of the text-parameter needs to be UTF-8 encoded!


  • Example:

Response Documents

All queries to the REST API return a document containing some tags, bundled in dimensions (think of them as categories). Response documents are available in XML and JSON syntax. returns XML syntax by default. If you want JSON output you need to append a parameter named view with "json" as it's value to your HTTP request.

XML View

<?xml version="1.0" encoding="UTF-8"?>
  <meme source="" updated="Tue May 02 15:55:30 CEST 2006">
    <dim type="title">
      <item>knallgrau | Company</item>
    <dim type="topic">
    <dim type="person">
      <item>Dieter Rappold</item>
    <dim type="size">
    <dim type="content-type">
    <dim type="location">
    <dim type="language">
    <dim type="author">
      <item>Ronald Malis</item>

JSON View;=json

           "updated":"Mon May 15 13:38:14 CEST 2006",
           "dimensions":{"title":["knallgrau | Company"],
           "person":["Dieter Rappold"],
           "author":["Ronald Malis"]}}]}

It's also possible to define a callback for the return JSON object. If the parameters callback and view=json are given the response is encapsulated in a function call to the given callback. So the above request would return MyFunc({"memes" ... }) if the parameter callback=MyFunc was present.

Every response document consists of a root element memes containing several meme objects which in turn contain the dimensions. Currently our service returns the following types of dimensions when given a text:

  • language - always present. value can be "unknown".
  • topic* **
  • location*
  • person*
All other dimensions are only returned when a URL is given:
  • title
  • size - the size of the resource in bytes
  • content-type - the mimetype of the resource
  • author*
* optional
** you can define the maximum number of returned topics by adding a parameter named count with the desired value to your request. if the parameter is omitted will return a maximum of 10 topics by default.


For the moment the service can be used free of charge. We do not limit the number of requests to it, however we ask you to send us a short notice whenever you plan to build an application that uses heavily.