Developers
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 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 available sorts) |
| category | 0 | The category id (see available categories) |
| region | all | The region code (see available regions) |
| type | all | The items type (see available types) |
| format | xml | xml or json |
Sample requests
A note on Essential widgets
Most of the Essential widgets are specially handled by Netvibes' internal system, and therefore their <link> 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.
Here are a few:
- Tools
- Calculator: http://www.netvibes.com/modules/calc/calc.html
- Services
- Amazon Wishlist: http://www.netvibes.com/modules/amazonWishList/amazonWishList.html
- Web Radio Player: http://www.netvibes.com/modules/webRadio/webRadio.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 <link> tag.
Here are the needed widgets for each wizard:
- MailWizard
- SocialWizard
Sample outputs
XML output
For the http://api.eco.netvibes.com/search/?query=tv&limit=2 request
<?xml version="1.0" encoding="UTF-8"?> <items total="1827" page="1" totalPages="-1827"> <item> <id>229453</id> <author>26052</author> <type id="6">uwa</type> <publicUrl> <![CDATA[http://eco.netvibes.com/widgets/229453]]> </publicUrl> <link> <![CDATA[http://www.feediz.com/widgets/www/index.php]]> </link> <title><![CDATA[Votre guide TV Télé-Loisirs]]></title> <description> <![CDATA[Notre Gadget TV vous permet de personnaliser la grille de vos émissions préférées diffusées en prime time. (...)]]> </description> <flags> <flag><![CDATA[campaign]]></flag> <flag><![CDATA[pick]]></flag> </flags> <regions> <region><![CDATA[bef]]></region> <region><![CDATA[chf]]></region> <region><![CDATA[fr]]></region> </regions> <categories> <category id="5"> <![CDATA[Art & Entertainment]]> </category> <category id="5"> <![CDATA[Art & Entertainment]]> </category> </categories> <featured><![CDATA[true]]></featured> <sponsored><![CDATA[true]]></sponsored> <campaignActive><![CDATA[true]]></campaignActive> <thumbnail width="160" height="120"> <![CDATA[http://eco.netvibes.com/img/xxx.png]]> </thumbnail> </item> <item> <id>232056</id> <author>32848</author> (...) </item> </items>
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":"<p>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, (...) } ]}
- Send to a friend
- Add to favorites
- Last modified: 2009/10/23 16:59

