Back to my page

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.

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:

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:

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

<?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,
 
(...)
 
  }
]}

Business

Partner with us.

Developers

Build once, run everywhere.

Community

Get involved, get localized.

Press

News. Media kits. Press releases.