API:v1r1:tags controller

From MixxHelp

Jump to: navigation, search

API Main

Contents

Tags Service 

/services/v1r1/tags/<action>

The tags service is straightforward, and offers the following actions:

popular

Retrieve Popular Tags 

GET http://api.mixx.com/services/v1r1/tags/popular?api_key=YOUR_API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" api_version="v1r1">
<tags>
<tag>
  <name>dsd</name>
  <permalink>http://www.mixx.com/tags/dsd</permalink>
</tag>
<tag>
  <name>lolcats</name>
  <permalink>http://www.mixx.com/tags/lolcats</permalink>
</tag>
<tag>
  <name>motherday</name>
  <permalink>http://www.mixx.com/tags/motherday</permalink>
</tag>
</tags>
</rsp>

popular_thingies

Retrieve Popular Items by Tag

It's worth noting that in the Mixx web application, tags and categories are really the same thing (even though they sometimes appear differently). That means that you can pass a category name as the 'name' parameter, and you'll retrieve items in that category. 

GET http://api.mixx.com/services/v1r1/tags/popular_thingies?name=lolcats&api_key=YOUR_API_KEY

<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" api_version="v1r1">
<thingies>
<thingy type="story" created_at="Fri Jan 25 22:16:10 UTC 2008" id="76799">
  <title>Friday Fest: Of LOLdiggs and Australians</title>
  <permalink>http://www.mixx.com/stories/76799/friday_fest_of_loldiggs_and_australians</permalink>
  <target_url>http://mixxingbowl.com/forums/index.php/topic,391.0.html</target_url>
  <description>YOUR CHALLENGE will be to create MORE LOLdiggs in the wake of the Digg Revolt 2008...  resulting designs
will also be posted at The-TrukstoP.com.  ALSO, we have an Aussie theme - tomorrow is Australia Day, and in tribute to Heath Ledger</description>
  <comment_count>8</comment_count>
  <vote_count>81</vote_count>
  <submitter name="cGt2099"/>
</thingy>
<thingy type="story" created_at="Sun Nov 11 16:04:55 UTC 2007" id="9243">
  <title>LOLbush</title>
  <permalink>http://www.mixx.com/stories/9243/lolbush</permalink>
  <target_url>http://www.the-trukstop.com/articles/2007/lolbush.html</target_url>
  <description>LOLcats + George Bush = LOLbush</description>
  <comment_count>2</comment_count>
  <vote_count>20</vote_count>
  <submitter name="cGt2099"/>
</thingy>
</thingies>
</rsp>

Retrieve Popular Items by Multiple Tags 

POST http://api.mixx.com/services/v1r1/tags/popular_thingies?api_key=YOUR_API_KEY

Data:
<? xml version="1.0" charset="UTF-8" ?>
<tags>
  <tag>lolcats</tag>
  <tag>motherday</tag>
</tags>

Result:
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" api_version="v1r1">
<thingies>
<thingy type="photo" created_at="Mon Apr 28 17:24:33 UTC 2008" id="159015">
  <title>testing image picker</title>
  <permalink>http://www.mixx.com/photos/159015/testing_image_picker</permalink>
  <target_url>http://stamping.thefuntimesguide.com/2007/04/mothers_day_card_1.php</target_url>
  <description>Easter is over and it's now time to think about Mother's Day cards. Fortunately, you don't 
need a special stamp set for these cards. Mother's Day cards can be made using any 'pretty' stamp or supplies....</description>
  <thumbnail type="image/jpeg">http://74.205.85.169:7500/images/photo_thumbnails/ed9f944fb4370f09553173f3f5a614f4720135e9_96s.jpg</thumbnail>
  <comment_count>0</comment_count>
  <vote_count>1</vote_count>
  <media_url>http://stamping.thefuntimesguide.com/images/blogs/Mothers_Day_Card1-thumb.jpg</media_url>
  <submitter name="Kerry"/>
</thingy>
<thingy type="photo" created_at="Mon Apr 28 17:22:41 UTC 2008" id="159014">
  <title>big mother's day graphic</title>
  <permalink>http://www.mixx.com/photos/159014/big_mother_s_day_graphic</permalink>
  <target_url>http://www.flowerpowernetwork.com/newsletter/data/images/mothersdayflowers.jpg</target_url>
  <description>test</description>
  <thumbnail type="image/jpeg">http://74.205.85.169:7500/images/photo_thumbnails/0ad83b589fdb37488fa8a32eee646180a7d99024_96s.jpg</thumbnail>
  <comment_count>0</comment_count>
  <vote_count>1</vote_count>
  <media_url>http://www.flowerpowernetwork.com/newsletter/data/images/mothersdayflowers.jpg</media_url>
  <submitter name="Kerry"/>
</thingy>
</thingies>
</rsp>
Retrieved from "http://help.mixx.com/API:v1r1:tags_controller"
Personal tools