Topic Classification API
The RankSpeed Topic Classification API instantly organizes any text feed into topics, tags and categories.
Text feeds can be status updates, posts, comments, documents, web pages or any set of texts.
Topics can optionally be returned with images, short descriptions and website url (if available), allowing users to navigate their feed visually.
Please contact us to access the API.
Request
To use the Topic Classification API, perform a HTTP POST request on the following endpoint:
http://rankspeed_server/topics/?textType=...&textFormat=...&returnDescription=...
Provide the following arguments:
ArgumentValuesDescription
textTypeplain | urlText feeds are sent as texts or urls
textFormatshort | longText feeds are short (status, title) or long documents
returnDescriptiontrue | falseReturn a description, image, website url for each topic
Provide the text feed in the HTTP body as the following example (json):
[
	{ "id":"yourID1", "text":"Sharon Stone's former nanny filed a lawsuit" },
	{ "id":"yourID2", "text":"Quotations by Marilyn Monroe, Born June 1, 1926" },
	{ "id":"yourID3", "text":"Barack Obama is the President of the United States" },
	{ "id":"yourID4", "text":"Marilyn Monroe was found dead from an overdose" },
	{ "id":"yourID5", "text":"Featuring over 1000 Sharon Stone pictures" },
	{ "id":"yourID6", "text":"Barack Obama 2012: news, video, and campaign" },
	{ "id":"yourID7", "text":"Everything you need to know about the iPhone 4S" },
	{ "id":"yourID8", "text":"A former nanny for Sharon Stone filed suit" }
]
			
Example Response
{
   "categories":
   [
      {
         "name":"People",
         "tags":
         [
            {"name":"American politician", "topics":[9046]},
            {"name":"American actress", "topics":[6324,8754]}
         ]
      },
      {
         "name":"Products",
         "tags":
         [
            {"name":"Smartphone", "topics":[7732]}
         ]
      }
   ]
  
   "topics":
   [
      {
         "id":"6324",
         "title":"Marilyn Monroe",
         "description":"Norma Jeane Mortensen Baker (June 1, 1926  August 5, 1962)",
         "image":".../Eisenstaedt-Monroe-1953.jpg",
         "feed":["yourID2","yourID4"]
      },
      {
         "id":"8754",
         "title":"Sharon Stone",
         "description":"Sharon Vonne Stone (born March 10, 1958) is an American actress",
         "image":".../Sharon_Stone_2005.jpg",
         "feed":["yourID1","yourID5","yourID8"]
      },
      {
         "id":"9046",
         "title":"Barack Obama",
         "description":"Barack Hussein Obama II (; born August 4, 1961) is the 44th...",
         "image":".../Official_portrait_of_Barack_Obama.jpg",
         "feed":["yourID3","yourID6"]
      },
      {
         "id":"7732",
         "title":"iPhone 4S",
         "description":"The iPhone 4S is a touchscreen-based, slate-sized 3G smartphone",
         "image":".../IPhone_4S_No_shadow.png",
         "feed":["yourID7"]
      }
   ]
}