======Ecosystem search====== This method allows you to implement Ecosystem's search into your application/tool. ===== Parameters ===== ^ Name ^ Default value ^ Description ^ | query | |The query string (equivalent to the search in [[http://eco.netvibes.com|Ecosystem]])| | page | 1 |The page| | limit | 20 |The limit of items returned| | thumbwidth | 160 |The thumbnails width| | thumbheight | 120 |The thumbnails height| | sort | popular |The sorting method (see [[:api:eco:sorts|available sorts]])| | category | 0 |The category id (see [[:api:eco:categories|available categories]])| | region | all |The region code (see [[:api:eco:region|available regions]])| | type | all |The items type (see [[:api:eco:types|available types]])| | format | xml |''xml'' or ''json''| ===== Sample requests ===== * http://api.eco.netvibes.com/search/?query=tv&limit=2 * http://api.eco.netvibes.com/search/?query=news&limit=4&type=uwa ===== A note on Essential widgets ===== Most of the Essential widgets are specially handled by Netvibes' internal system, and therefore their '''' tag will not feature the widget's URL, but it's internal codename. If you intend to use some essential widgets, you will need to know their direct URL. Essential widget where first and foremost written for Netvibes, and some might make Netvibes-specific calls. Therefore, keep in mind that not all of these widgets will work outside of Netvibes. The given URLs are subject to change at any time. Here are a few: * //Tools// * Calculator: http://www.netvibes.com/modules/calc/calc.html * FeedReader: http://www.netvibes.com/modules/feedReader/feedReader.html * Flash: http://www.netvibes.com/modules/flash/flash.html * Image: http://www.netvibes.com/modules/imageModule/imageModule.html * Link: http://www.netvibes.com/modules/linkModule/linkModule.html * To Do List: http://www.netvibes.com/modules/todolist/todolist.html * WebNote: http://www.netvibes.com/modules/postIt/postIt.html * //Services// * Alexa: http://www.netvibes.com/modules/alexa/alexa.html * Amazon Wishlist: http://www.netvibes.com/modules/amazonWishList/amazonWishList.html * Cashback: http://www.netvibes.com/modules/cashback/cashback.html * del.icio.us: http://www.netvibes.com/modules/delicious/delicious.html * Digg: http://www.netvibes.com/modules/diggOfficial/diggOfficial.html * Expedia: http://www.netvibes.com/modules/expedia/expedia.html * Expedia US: http://www.netvibes.com/modules/expediaUS/expediaUS.html * Flickr: http://www.netvibes.com/modules/flickr/flickr.html * Twitter: http://www.netvibes.com/modules/twitter/twitter.html * Weather: http://www.netvibes.com/modules/weather/weather.html * Web Radio Player: http://www.netvibes.com/modules/webRadio/webRadio.html * Wikinvest: http://www.netvibes.com/modules/wikinvest/wikinvest.html * White Pages: http://www.netvibes.com/modules/whitepages/whitepages.html * Zoho: http://www.netvibes.com/modules/zoho/zoho.html The following are not (yet) available as UWA widgets: * BlogMarks * Bookmarks * Box.net * Craigslist * eBay * iCal * Image Search * Maps Search * Shopping Search * Wall * Web Search ==== About 'Wizard' widgets ==== Among Essential widgets are a few wizard widgets - that is, widget that forward the user to a given widget, depending on his choices. These wizard widget can only work wihtin Netvibes, and are marked as '*Wizard' in the Eco API result's '''' tag. Here are the needed widgets for each wizard: * //MailWizard// * AOL Mail: http://www.netvibes.com/modules/aolMail/aolMail.html * GMail: http://www.netvibes.com/modules/gmail/gmail.html * Hotmail: http://www.netvibes.com/modules/hotmail/hotmail.html * .mac mail: http://www.netvibes.com/modules/macMail/macMail.html * POP mail: http://www.netvibes.com/modules/popmail/popmail.html * Yahoo! Mail: http://www.netvibes.com/modules/yahoomail/yahoomail.html * //SocialWizard// * Facebook: http://www.netvibes.com/modules/facebook/facebook.html * MySpace: http://www.netvibes.com/modules/myspace/myspace.html ===== Sample outputs ===== The sample outputs below are not definitive! Outputs are bound to change depending on your request. Long strings have been shortened for readability. Real outputs always feature full-text. ==== XML output ==== For the http://api.eco.netvibes.com/search/?query=tv&limit=2 request 229453 26052 uwa <![CDATA[Votre guide TV Télé-Loisirs]]> 232056 32848 (...) ==== JSON output ==== For the http://api.eco.netvibes.com/search/?query=tv&limit=2&format=json request { "total":1827, "page":1, "totalPages":-1827, "thumbnailWidth":160, "thumbnailHeight":120, "items":[ { "id":229453, "author":26052, "type":6, "typeString":"uwa", "publicUrl":"http:\/\/eco.netvibes.com\/widgets\/229453", "link":"http:\/\/www.feediz.com/\widgets/\www/\index.php", "flags":["campaign","pick"], "title":"Votre guide TV Télé-Loisirs", "summary":"Notre Gadget TV vous permet de (...)", "description":"Notre Gadget TV vous permet de (...)", "descriptionHtml":"

Notre Gadget TV vous (...)<\/p>", "featured":true, "sponsored":true, "campaignActive":true, "regions":["bef","chf","fr"], "categories":[{ "id":"5","label":"Art & Entertainment" }], "thumbnail":"http:\/\/eco.netvibes.com\/img\/xxxx.png", "modified":"1203549119"}, { "id":232056, "author":32848, (...) } ]}