URL:
http://twick.it/interfaces/api/find_topic.xml
http://twick.it/interfaces/api/find_topic.json
Function:
Retrieves all topics which includes a given search term. Only the topic's title is searched for the search term not the Twicks.
Parameters:
| Optional/required | Values | Default | Description | |
| search | required | String | Search term that should be included in the topic. | |
| limit | optional | Integer > 0 | 1 | Number of Twicks that should be returned. |
| lng | optional | "de", "en" | preferred browser language | Language in which should be searched |
Output(XML):
http://twick.it/interfaces/api/find_topic.xml?search=Homer
<?xml version="1.0" encoding="utf-8"?>
<result>
<query>type=xml&search=Homer</query>
<topics>
<topic>
<id>307</id>
<title>Homer</title>
<url>http://twick.it/de/Homer</url>
<tags>
<tag count="2">dichter</tag>
<tag count="1">odyssee</tag>
<tag count="1">ilias</tag>
<tag count="1">erster</tag>
<tag count="1">autor</tag>
<tag count="1">abendlandes</tag>
</tags>
<geo>
<latitude></latitude>
<longitude></longitude>
</geo>
</topic>
<topic>
<id>295</id>
<title>Homer Simpson</title>
<url>http://twick.it/de/Homer-Simpson</url>
<tags>
<tag count="2">simpsons</tag>
<tag count="2">us</tag>
<tag count="1">dicker</tag>
<tag count="1">serie</tag>
<tag count="1">zeichentrick</tag>
<tag count="1">figur</tag>
<tag count="1">rüpel</tag>
<tag count="1">isst</tag>
<tag count="1">gerne</tag>
<tag count="1">lustige</tag>
</tags>
<geo>
<latitude></latitude>
<longitude></longitude>
</geo>
</topic>
</topics>
</result>
Output (JSON):
http://twick.it/interfaces/api/find_topic.json?search=Homer
{
"query" : "type=json&search=Homer",
"topics" : [
{
"id" : "307",
"title" : "Homer",
"url" : "http://twick.it/de/Homer",
"tags" : [
{
"tag" : "dichter",
"count" : "2"
},
{
"tag" : "odyssee",
"count" : "1"
},
{
"tag" : "ilias",
"count" : "1"
},
{
"tag" : "erster",
"count" : "1"
},
{
"tag" : "autor",
"count" : "1"
},
{
"tag" : "abendlandes",
"count" : "1"
}
],
"geo" : {
"latitude" : "",
"longitude" : ""
},
},
{
"id" : "295",
"title" : "Homer Simpson",
"url" : "http://twick.it/de/Homer-Simpson",
"tags" : [
{
"tag" : "simpsons",
"count" : "2"
},
{
"tag" : "us",
"count" : "2"
},
{
"tag" : "dicker",
"count" : "1"
},
{
"tag" : "serie",
"count" : "1"
},
{
"tag" : "zeichentrick",
"count" : "1"
},
{
"tag" : "figur",
"count" : "1"
},
{
"tag" : "rüpel",
"count" : "1"
},
{
"tag" : "isst",
"count" : "1"
},
{
"tag" : "gerne",
"count" : "1"
},
{
"tag" : "lustige",
"count" : "1"
}
],
"geo" : {
"latitude" : "",
"longitude" : ""
},
}
]
}




