# Ecosia Scraper API: Search Results as Typed JSON | Scrapier (https://scrapier.io/scrapers/ecosia/)

> Ecosia scraper API: Ecosia search results with position, title, link, domain and source as typed JSON, by region. 2 credits per call. Get a free API key today.

Last updated: 2026-11-10

## Ecosia Scraper API: _1 endpoint_, structured JSON

Ecosia search results, ranked and typed: position, title, link, domain and source for any query, in the region you choose. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**1**Ecosia endpoint

**2**credits per successful call

**0**credits for a failed call

**1**need no Ecosia login

Quick answerScrapier returns typed JSON from **1 Ecosia endpoint**: web search results by region. Public data only and no proxies; no Ecosia login needed. 2 credits per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with Ecosia Scraper?

One endpoint covers Ecosia search. Send one keyword and a region and get clean JSON back for 2 credits per successful call.

### Ecosia SearchStart here

`**GET**/api/v2/ecosia-search/`

Ecosia results for one query and region: position, title, link, domain and source, a page at a time.

2 credits per call_View →Page soon_

Playground

## Try Ecosia Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

Ecosia**Ecosia Search**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping Ecosia cost?

Every successful call costs 2 credits, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 2 credits cost $3.16. Scale brings that to $2.39, so 125,000 Ecosia calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $3.87 |
| Pro | $79 | 50,000 | $3.16 |
| Scale | $299 | 250,000 | $2.39 |

How to

## How do I use Ecosia Scraper?

Built to be easy to start with, even if you've never scraped a search engine. Here's how to get Ecosia results in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**`ecosia-search` returns the results for one query on ecosia.org.
3. **Add your input**One keyword in `queries` per call, plus an optional `region` such as `en-us`.
4. **Page through the results**List endpoints return `next_cursor`; pass it back as `cursor` for the next page. `null` means the last page. The region stays locked in the cursor.
5. **Track many keywords**Loop over your keyword list, one call per query, with up to 3 calls in parallel per key.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Every endpoint takes the same kind of input.

1

### By keyword

You don't know the items yet: find them with a keyword.

Ecosia Search`climate change`

Best fordiscovery · plain text, "travel" not "#travel"

Example requests

// GET /api/v2/ecosia-search/
{
  "queries": "climate change",
  "region": "en-us",
  "include\_html": "true"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Keyword | `queries` | Ranked results with title, link, domain and source |
| Region | `region` | Results for that search market, such as en-us |
| Highlights | `include_html` | HTML-highlighted title and snippet fields |
| Cursor | `cursor` | The next page of the same query and region |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/ecosia-search/?queries=climate change
// one item of data.results · catalog sample
{
  "type": "organic",
  "resultType": "web",
  "position": 1,
  "page": 0,
  "title": "Climate Change | United Nations",
  "link": "https://www.un.org/en/climatechange",
  "url": "https://www.un.org/en/climatechange",
  "domain": "un.org",
  "source": "United Nations",
  "query": "climate change",
  "region": "en-us",
  "scrapedAt": "2026-09-16T08:09:32.769883+00:00"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with Ecosia data?

Public Ecosia results help with SEO checks, competitor research and search-engine comparisons. Here are three common jobs and the Ecosia scraper endpoint each one uses.

01

### Ecosia rank checks

See where your pages appear on Ecosia for each target keyword and region. Store position, link and domain per week to see which pages gain or lose ground.

1. _1_search
2. Rank history

WeeklySheets, dashboard

02

### Search engine comparison

Run the same keywords on Ecosia and on other engines in the catalog, then compare which domains rank in each. Find the gaps where one engine favours a competitor.

1. _1_search
2. Engine comparison

MonthlyDashboard, CSV

03

### Topic and source research

Read which sources rank on Ecosia for a sustainability or climate topic before you publish. Group results by domain to see who owns the subject.

1. _1_search
2. Source list

Per projectDocs, CSV

Features

## Features

Ecosia Scraper fetches clean, structured Ecosia search results at a fixed cost per call: built for SEO checks, research and AI agents.

### Live data, every call

Each request reads Ecosia at call time, and every result says when in `scrapedAt`.

### Typed, consistent JSON

Same field names on every call, numbers as numbers, ready for code, sheets or an LLM.

### Lists, page by page

Results come a page at a time with `next_cursor`; run up to 3 requests in parallel per key.

### One endpoint, one shape

Every result has the same fields: position, title, link, URL, domain, source, query and region.

### MCP-ready for AI agents

The Scrapier MCP server reaches every Ecosia endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No proxies to manage

Public data only. No Ecosia account or login; Scrapier routes the request for you.

### Maintained for you

When Ecosia changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

2 credits per call, however many results the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this Ecosia Scraper?

Ecosia does not offer a public search results API to developers. Scrapier reads the public Ecosia result pages with one API key and returns typed JSON, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$2.39**Per 1,000 calls on Scale

At 2 credits a call. Flat per-call pricing, no compute units or bandwidth to estimate.

**0**Setup steps on Ecosia

No Ecosia account, browser or HTML parser to set up.

**1 key**For 35 platforms

The same key and JSON envelope cover Google, Amazon, TikTok, YouTube and more.

| Feature | Scrapier Ecosia Scraper | Official API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Public Ecosia results | No public API | Public Ecosia results |
| Setup | One API key | No public API | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | No public API | Breaks on layout changes |
| Cost | From $2.39 per 1,000 calls | No public API | Servers, proxies and engineering time |
| AI agents | MCP server included | No public API | Build your own |

FAQ

## Frequently asked questions

### What data does the Ecosia scraper return?

Ecosia results for one query, under results. Each result has type, resultType, position, page, title, link, url, domain, source, query, region and scrapedAt. The response also gives next\_cursor for the next page.

### Can I choose the Ecosia region?

Yes. Set region to the search market you want, such as en-us, the default. The region is locked into the cursor, so every page of one query comes from the same market.

### What does include\_html do?

With include\_html set to true, the default, the response also emits HTML-highlighted fields, where the matched words are wrapped in em tags. Set it to false if you only want plain text fields.

### How do I get more than one page of Ecosia results?

Read next\_cursor from the response and send it back as cursor. Each page is one call at 2 credits. When next\_cursor is null you have reached the last page Ecosia shows for that query.

### Can I send several keywords in one call?

No. Each call takes one keyword in queries. To track a list, loop over it and run up to 3 calls in parallel per key; failed or throttled calls cost nothing, so retries are free.

### Do I need an Ecosia account?

No. Scrapier reads public Ecosia result pages for you, so there is no Ecosia account or login to create. You only need a Scrapier API key, sent in the X-API-Key header.

### How much does the Ecosia scraper cost?

Ecosia Search costs 2 credits per successful call, however many results the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### Can I get the raw Ecosia response?

Yes. Set raw\_data to true and the response carries the raw upstream payload under raw\_responses instead of the formatted results. Pagination with cursor and next\_cursor works the same way in both modes.

### Is it legal to scrape Ecosia?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible Ecosia data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use and check Ecosia's terms.

### Can I connect Ecosia data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON under data.

### Can I get Ecosia data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Ecosia endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### Ecosia Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### What are the Ecosia scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

### How do I scrape Ecosia with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/ecosia-search/", headers={"X-API-Key": key}, params={"queries": "climate change"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["results"\] directly; there is no HTML to parse. Each call returns one page.

Other platforms

## You might also like

[### Google

12 endpoints](https://scrapier.io/scrapers/google/)[### Bing

1 endpoint](https://scrapier.io/scrapers/bing/)[### Yahoo

1 endpoint](https://scrapier.io/scrapers/yahoo/)[### DuckDuckGo

1 endpoint](https://scrapier.io/scrapers/duckduckgo/)[### Yandex

1 endpoint](https://scrapier.io/scrapers/yandex/)[### Baidu

1 endpoint](https://scrapier.io/scrapers/baidu/)

Get started

## Start pulling Ecosia data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 1 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/ecosia/
Site index for AI agents: https://scrapier.io/llms.txt
