SuperTrendingData API (1.2.3)

Methods

Notes:

There is a crossdomain.xml file located at the root of the api. At this time SuperTrendingData does not store a local version of the image files so access to the binary data via Flash is on a per domain basis.

method: url

What it does:

Returns entity data for a url

Required Arguments:

Optional Arguments:

Request:

Response:

{
   "action": "url", 
   "api": "1.2.0", 
   "entity": {
      "url": "http:\/\/yfrog.com\/6byykij", 
      "image": "http:\/\/yfrog.com\/6byykij:iphone", 
      "sizes": [
         {
            "src": "http:\/\/yfrog.com\/6byykij.th.jpg", 
            "width": 150, 
            "type": "small", 
            "orientation": "landscape", 
            "height": 113
         }, 
         {
            "src": "http:\/\/yfrog.com\/6byykij:iphone", 
            "width": 480, 
            "type": "large", 
            "orientation": "square", 
            "height": 480
         }
      ], 
      "name": "YFrog", 
      "id": "6byykij"
   }
}

method: image/recent

What it does:

Returns a list of up to 10 recently uploaded images optionally for a user based on userName

Optional Arguments:

Request:

Response:

{
   "action": "\/image\/recent", 
   "images": [
      {
         "srcTweetId": "29457832960", 
         "srcUser": "TheShilpaShetty", 
         "shortUrl": "fSbs", 
         "srcText": "Will be at the Iosis opening at 4pm,Odeon mall ghatkopar east:)Tips for looking fit n looking good this festive season will be shared:)c ya", 
         "srcUserIconUrl": "http:\/\/a1.twimg.com\/profile_background_images\/119358082\/shilpa-shetty4-276x300.jpg", 
         "srcImageId": "AMIfv96hr5Cfaw6Ys1UEg58pJwg-t1YjbgSKRXcAGxBVBWn2yFePLRAr0l6zYr_3jne_Lanw5sHgD8T4t7cqq_qOmIjkTS9i_5xhYQOlkMV8mOp0aDcdQOtIE7bPYJQX7Rlz80TxPcYi-vznmzbiSRKoRvbkeZ4cyw", 
         "authorUser": "niraj_joshi1988", 
         "srcUserName": "SHILPA SHETTY", 
         "authorUserName": "Apple News Daily"
      },
      ... 
      ], 
   "api": "1.2.1"
}

method: tweet

What it does:

Returns entity data for tweet text or for a tweet based on id

Required Arguments:

Optional Arguments:

Request:

Response:

{
   "action": "tweet", 
   "entities": [
      {
         "indices": [
            64, 
            87
         ], 
         "url": "http:\/\/yfrog.com\/6dec3j", 
         "type": "image", 
         "media": {
            "url": "http:\/\/yfrog.com\/6dec3j", 
            "image": "http:\/\/yfrog.com\/6dec3j:iphone", 
            "sizes": [
               {
                  "src": "http:\/\/yfrog.com\/6dec3j.th.jpg", 
                  "width": 150, 
                  "type": "small", 
                  "orientation": "landscape", 
                  "height": 113
               }, 
               {
                  "src": "http:\/\/yfrog.com\/6dec3j:iphone", 
                  "width": 480, 
                  "type": "large", 
                  "orientation": "square", 
                  "height": 480
               }
            ], 
            "name": "YFrog", 
            "id": "6dec3j"
         }
      }
   ], 
   "api": "1.2.0", 
   "method": "id"
}

method: trends

What it does:

Returns a list of current trends the json object will always have all keys but may not have a description or an image associated with the trend. The rank is based on the amount of information available for the trend and the rank from the trend sources.

Required Arguments:

Optional Arguments:

Request:

Response:

{
   "supertweets": [
		{
         "url": "http:\/\/twitpic.com\/32y6od", 
         "media": {
            "name": "TwitPic", 
            "sizes": [
               {
                  "src": "http:\/\/twitpic.com\/show\/mini\/32y6od", 
                  "width": 75, 
                  "type": "small", 
                  "orientation": "square", 
                  "height": 75
               }, 
               {
                  "src": "http:\/\/twitpic.com\/show\/thumb\/32y6od", 
                  "width": 150, 
                  "type": "small", 
                  "orientation": "square", 
                  "height": 150
               }, 
               {
                  "src": "http:\/\/twitpic.com\/show\/large\/32y6od", 
                  "width": 600, 
                  "type": "grande", 
                  "orientation": "portrait", 
                  "height": 900
               }
            ], 
            "url": "http:\/\/twitpic.com\/32y6od", 
            "image": "http:\/\/twitpic.com\/show\/large\/32y6od", 
            "tweets": 1, 
            "id": "32y6od"
         }, 
         "tweets": [
            {
               "text": "#salonduchocolat in Paris : AMAZING ! :D ", 
               "profile_image_url": "http:\/\/a1.twimg.com\/profile_images\/1152130737\/__normal.jpg", 
               "entities": [
                  {
                     "indices": [
                        41, 
                        66
                     ], 
                     "url": "http:\/\/twitpic.com\/32y6od", 
                     "type": "image"
                  }
               ], 
               "from_user": "Clem029210Music", 
               "from_user_id": 147577460, 
               "id": 29372953086
            }
         ]
      }
      ...
   ], 
   "api": {
      "version": "0.9.0"
   }, 
   "time": 2.47756195068
}

method: trend

What it does:

Returns images from the twitter search api based on the URL encoded query string.

Required Arguments:

Optional Arguments:

Request:

Response:

{
   "supertrends": [
      {
         "sources": [
            {
               "name": "SuperTwitter", 
               "rank": 99, 
               "images": [
                  {
                     "url": "http:\/\/media.brizzly.com\/4cb86e0a9cb27d7dd399ff8fce41e608\/Ayyy_Girl.jpg", 
                     "image": "http:\/\/media.brizzly.com\/4cb86e0a9cb27d7dd399ff8fce41e608\/Ayyy_Girl.jpg", 
                     "id": "Ayyy_Girl.jpg", 
                     "name": "Brizzly"
                  }, 
                  {
                     "url": "http:\/\/yfrog.com\/4jq6lj", 
                     "image": "http:\/\/yfrog.com\/4jq6lj:iphone", 
                     "id": "4jq6lj", 
                     "name": "YFrog"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vnzk\/\/", 
                     "image": "http:\/\/twitpic.com\/show\/large\/", 
                     "id": "", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vo3l", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vo3l", 
                     "id": "32vo3l", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vnzk", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vnzk", 
                     "id": "32vnzk", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/yfrog.com\/jcf5rj", 
                     "image": "http:\/\/yfrog.com\/jcf5rj:iphone", 
                     "id": "jcf5rj", 
                     "name": "YFrog"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vmuw", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vmuw", 
                     "id": "32vmuw", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/yfrog.com\/jwmfj", 
                     "image": "http:\/\/yfrog.com\/jwmfj:iphone", 
                     "id": "jwmfj", 
                     "name": "YFrog"
                  }, 
                  {
                     "url": "http:\/\/www.youtube.com\/watch?v=dwBMe7LpOEY&feature=player_embedded#", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/dwBMe7LpOEY\/0.jpg", 
                     "id": "dwBMe7LpOEY", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vlij", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vlij", 
                     "id": "32vlij", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/yfrog.com\/ncanj", 
                     "image": "http:\/\/yfrog.com\/ncanj:iphone", 
                     "id": "ncanj", 
                     "name": "YFrog"
                  }, 
                  {
                     "url": "http:\/\/plixi.com\/p\/54311970", 
                     "image": "http:\/\/TweetPhotoAPI.com\/api\/TPAPI.svc\/imagefromurl?size=big&url=http:\/\/tweetphoto.com\/54311970", 
                     "id": "54311970", 
                     "name": "TweetPhoto"
                  }, 
                  {
                     "url": "http:\/\/youtu.be\/L6vgO9gOEi4", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/L6vgO9gOEi4\/0.jpg", 
                     "id": "L6vgO9gOEi4", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/youtu.be\/3uTRwipHHs4?a", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/3uTRwipHHs4\/0.jpg", 
                     "id": "3uTRwipHHs4", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/www.youtube.com\/watch?v=lAdpr1p0TSk", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/lAdpr1p0TSk\/0.jpg", 
                     "id": "lAdpr1p0TSk", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vk1n", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vk1n", 
                     "id": "32vk1n", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/www.youtube.com\/watch?v=3uTRwipHHs4", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/3uTRwipHHs4\/0.jpg", 
                     "id": "3uTRwipHHs4", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/twitpic.com\/32vnv9", 
                     "image": "http:\/\/twitpic.com\/show\/large\/32vnv9", 
                     "id": "32vnv9", 
                     "name": "TwitPic"
                  }, 
                  {
                     "url": "http:\/\/www.youtube.com\/watch?v=lAdpr1p0TSk&feature=sub", 
                     "image": "http:\/\/i3.ytimg.com\/vi\/lAdpr1p0TSk\/0.jpg", 
                     "id": "lAdpr1p0TSk", 
                     "name": "YouTube"
                  }, 
                  {
                     "url": "http:\/\/yfrog.com\/86vcswj", 
                     "image": "http:\/\/yfrog.com\/86vcswj:iphone", 
                     "id": "86vcswj", 
                     "name": "YFrog"
                  }
               ], 
               "query": "Ayyy Girl", 
               "id": "Ayyy%20Girl", 
               "description": "On Nov. 1, Korean boyband JYJ released their music video for their single \"Ayyy Girl\".\r\n\r\nhttp:\/\/www.allkpop.com\/2010\/11\/jyjs-ayyy-girl-mv-is-finally-here"
            }
         ], 
         "id": "Ayyy%20Girl", 
         "rank": 99
      },
      ...
	], 
   "version": "0.6"
}

Change Log

11/07/2010

11/6/2010

11/1/2010

time passes....

06/01/2010

05/31/2010

05/26/2010

05/24/2010

05/23/2010

05/22/2010

05/20/2010