NOTE: Samples may be not completely displayed on the browser. Use the raw version of this gist to check them properly.
This gist describes the format we use to get information from our different sources. The samples are obtained using the words API, note that format may differ (and in fact it does in almost every case) when using the items API. eWebHunter consumes three services for each provider:
- words: To search for items related to keywords
- users: To follow particular users
- items: To describe specific items
For Youtube we use:
- for words: http://gdata.youtube.com/feeds/api/videos?alt=json&q=[KEYWORD]
- for users: http://gdata.youtube.com/feeds/api/users/[USER]/uploads?alt=json
- for items: http://gdata.youtube.com/feeds/api/videos/[KEY]?alt=json
- sample: {"id":{"$t":"http://gdata.youtube.com/feeds/api/videos/g5GW0qfah9E"},"published":{"$t":"2010-12-16T18:24:25.000Z"},"updated":{"$t":"2010-12-16T18:28:00.000Z"},"category":[{"scheme":"http://schemas.google.com/g/2005#kind","term":"http://gdata.youtube.com/schemas/2007#video"},{"scheme":"http://gdata.youtube.com/schemas/2007/categories.cat","term":"People","label":"People & Blogs"},{"scheme":"http://gdata.youtube.com/schemas/2007/keywords.cat","term":"webcam"},{"scheme":"http://gdata.youtube.com/schemas/2007/keywords.cat","term":"video"},{"scheme":"http://gdata.youtube.com/schemas/2007/keywords.cat","term":"mogostosoft"}],"title":{"$t":"First Test Video","type":"text"},"content":{"$t":"Webcam video by the Hawk Oculyst","type":"text"},"link":[{"rel":"alternate","type":"text/html","href":"http://www.youtube.com/watch?v=g5GW0qfah9E&feature=youtube_gdata"},{"rel":"http://gdata.youtube.com/schemas/2007#video.responses","type":"application/atom+xml","href":"http://gdata.youtube.com/feeds/api/videos/g5GW0qfah9E/responses"},{"rel":"http://gdata.youtube.com/schemas/2007#video.related","type":"application/atom+xml","href":"http://gdata.youtube.com/feeds/api/videos/g5GW0qfah9E/related"},{"rel":"http://gdata.youtube.com/schemas/2007#mobile","type":"text/html","href":"http://m.youtube.com/details?v=g5GW0qfah9E"},{"rel":"self","type":"application/atom+xml","href":"http://gdata.youtube.com/feeds/api/users/mogostosoft/uploads/g5GW0qfah9E"}],"author":[{"name":{"$t":"mogostosoft"},"uri":{"$t":"http://gdata.youtube.com/feeds/api/users/mogostosoft"}}],"gd$comments":{"gd$feedLink":{"href":"http://gdata.youtube.com/feeds/api/videos/g5GW0qfah9E/comments","countHint":0}},"yt$location":{"$t":"Marcos Paz 2027, Monte Castro, Distrito Federal, Argentina geo:alt=50"},"media$group":{"media$category":[{"$t":"People","label":"People & Blogs","scheme":"http://gdata.youtube.com/schemas/2007/categories.cat"}],"media$content":[{"url":"http://www.youtube.com/v/g5GW0qfah9E?f=user_uploads&app=youtube_gdata","type":"application/x-shockwave-flash","medium":"video","isDefault":"true","expression":"full","duration":8,"yt$format":5},{"url":"rtsp://v4.cache8.c.youtube.com/CigLENy73wIaHwnRh9qn0paRgxMYDSANFEgGUgx1c2VyX3VwbG9hZHMM/0/0/0/video.3gp","type":"video/3gpp","medium":"video","expression":"full","duration":8,"yt$format":1},{"url":"rtsp://v1.cache5.c.youtube.com/CigLENy73wIaHwnRh9qn0paRgxMYESARFEgGUgx1c2VyX3VwbG9hZHMM/0/0/0/video.3gp","type":"video/3gpp","medium":"video","expression":"full","duration":8,"yt$format":6}],"media$description":{"$t":"Webcam video by the Hawk Oculyst","type":"plain"},"media$keywords":{"$t":"webcam, video, mogostosoft"},"media$player":[{"url":"http://www.youtube.com/watch?v=g5GW0qfah9E&feature=youtube_gdata_player"}],"media$thumbnail":[{"url":"http://i.ytimg.com/vi/g5GW0qfah9E/0.jpg","height":240,"width":320,"time":"00:00:04"},{"url":"http://i.ytimg.com/vi/g5GW0qfah9E/1.jpg","height":90,"width":120,"time":"00:00:02"},{"url":"http://i.ytimg.com/vi/g5GW0qfah9E/2.jpg","height":90,"width":120,"time":"00:00:04"},{"url":"http://i.ytimg.com/vi/g5GW0qfah9E/3.jpg","height":90,"width":120,"time":"00:00:06"}],"media$title":{"$t":"First Test Video","type":"plain"},"yt$duration":{"seconds":"8"}},"gd$rating":{"average":5.0,"max":5,"min":1,"numRaters":1,"rel":"http://schemas.google.com/g/2005#overall"},"yt$recorded":{"$t":"2010-12-16"},"yt$statistics":{"favoriteCount":"0","viewCount":"4"}}
For Plixi we use:
- for words: http://api.plixi.com/api/tpapi.svc/json/photos?search=[KEYWORD]
- for users: http://api.plixi.com/api/tpapi.svc/json/users/[USER_ID]/photos
- for user_ids: http://api.plixi.com/api/tpapi.svc/json/users/[USER]
- for items: http://api.plixi.com/api/tpapi.svc/json/photos/[KEY]
- sample: {"Album":{"AlbumId":20274,"CreatedDateString":"1970-01-01T00:00:00Z","Locked":false,"Name":"Erlang Diplomma"},"BigImageUrl":"http://c0013643.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","CommentCount":0,"DetailsUrl":"http://api.plixi.com/api/tpapi.svc/photos/76744958","GdAlias":"76744958","Id":76744958,"LargeImageUrl":"http://c0013643.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","LikedVotes":1,"Location":{"Latitude":0,"Longitude":0},"MediumImageUrl":"http://c0013644.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","Message":"mogosto's hawk oculyst with his diplomma","MobileImageUrl":"http://c0013645.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","Name":"x2_49308fe","SmallImageUrl":"http://c0013646.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","ThumbnailUrl":"http://c0013647.cdn1.cloudfiles.rackspacecloud.com/x2_49308fe","TinyAlias":"76744958","UnLikedVotes":0,"UploadDate":1297537474,"UploadDateString":"2011-02-12T19:04:34Z","UserId":8208723,"Views":34,"Vote":null}
For Twitpic we use:
- for words: http://api.twitpic.com/2/tags/show.json?tag=[KEYWORD]
- for users: http://api.twitpic.com/2/users/show.json?username=[USER]
- for items: http://api.twitpic.com/2/media/show.json?id=[KEY]
- sample: {"id":"240393180","short_id":"3z4gkc","user_id":"17878225","source":"site","message":"#mogosto 's hawk oculyist and his favourite picture","views":"5","width":"2048","height":"1536","size":"799408","type":"jpg","status_id":"0","in_reply_to_status_id":"0","in_reply_to_user_id":"0","location":"","timestamp":"2011-02-12 22:49:51","application":null,"user":null,"video":null,"faces":null,"comments":null,"events":null,"tags":null}
For Flickr we use:
- for words: http://api.flickr.com/services/rest/?method=flickr.photos.search&format=json&api_key=[API_KEY]&text=[KEYWORD]&extras=date_upload,owner_name,tags
- for users: http://api.flickr.com/services/rest/?method=flickr.people.getPublicPhotos&format=json&api_key=[API_KEY]&user_id=[USER_ID]&extras=date_upload,owner_name,tags
- for items: http://api.twitpic.com/2/media/show.json?id=[KEY]
- sample: {"id":"5266794024","owner":"57150287@N06","secret":"975278e28e","server":"5050","farm":6,"title":"The Mogosto Founders","ispublic":1,"isfriend":0,"isfamily":0,"dateupload":"1292522674","ownername":"mogosto","tags":"mogostosoft mogosto"}