OpenSERP Cloud Updated Quickstart →

Ecosia Search API

Query Ecosia and get structured web results as JSON. Ecosia runs on Bing's index, so its coverage is close to Bing with a European lean and its own ranking t...

Query Ecosia and get structured web results as JSON. Ecosia runs on Bing’s index, so its coverage is close to Bing with a European lean and its own ranking tweaks. This page shows an Ecosia search in the SDKs and with curl.

Examples run against OpenSERP Cloud at https://api.openserp.org. Ecosia is a Cloud-only engine. The other five engines also run on a self-hosted open-source OpenSERP server.

export OPENSERP_API_KEY="osk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

JavaScript / TypeScript

npm install @openserp/sdk

import { OpenSERP } from "@openserp/sdk";

const client = new OpenSERP({ apiKey: process.env.OPENSERP_API_KEY });

const { results } = await client.search({
  engine: "ecosia",
  text: "renewable energy startups",
  limit: 10,
  region: "DE",
});

for (const r of results) {
  console.log(r.rank, r.title, r.url);
}

Python

pip install openserp

import os
from openserp import OpenSERP

with OpenSERP(api_key=os.environ["OPENSERP_API_KEY"]) as client:
    response = client.search(engine="ecosia", text="renewable energy startups", limit=10, region="DE")
    for r in response.results:
        print(r.rank, r.title, r.url)

curl

curl "https://api.openserp.org/v1/ecosia/search?text=renewable+energy+startups&limit=10&region=DE" \
  -H "Authorization: Bearer $OPENSERP_API_KEY"

Preview a query in the Search Playground before wiring it into code.

When to reach for Ecosia

  • You want Bing-quality coverage with Ecosia’s European lean and ranking tweaks.
  • You are building a European-market dataset and want an engine beyond Google and Bing.
  • You want another engine in the megasearch mix without much overlap penalty - Ecosia and Bing results are related, so pair Ecosia with Google or Yandex for broader coverage.

Because Ecosia is Bing-powered, compare it with the Bing Search API example to see where the two diverge.

Next steps