Ecosia Search Scraper

Scrapes normalized organic search results from Ecosia.

What this Actor collects

The Actor converts Ecosia organic results into one clean JSON record per result, including title, canonical and displayed URLs, domain, snippet, rich-result metadata when present, page position, locale, and search provenance.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 51-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Search and competitor research
• Ranking and visibility monitoring
• Dataset and workflow enrichment

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
query	string	Yes	"artificial intelligence"	Keywords to search on Ecosia.
maxItems	integer	No	25 (maximum 100)	Maximum number of complete, unique organic records to save.
maxPages	integer	No	3 (maximum 10)	Maximum number of Ecosia result pages to inspect.
region	string	No	"us-en"	Country-language code used for browser locale and dataset context, such as us-en.
proxyConfiguration	object	No	{"useApifyProxy":false}	Optional Apify Proxy configuration for blocked hosted requests.
maxRequestRetries	integer	No	3	Maximum retries with fresh browser/proxy sessions after transient failures.
requestTimeoutSecs	integer	No	90	Maximum request-handler duration in seconds.
navigationTimeoutSecs	integer	No	60	Maximum browser navigation duration in seconds.
headless	boolean	No	true	Run the browser without a visible UI.

Example input

{
  "query": "artificial intelligence",
  "maxItems": 5,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "region": "us-en",
  "maxRequestRetries": 3,
  "requestTimeoutSecs": 90,
  "navigationTimeoutSecs": 60,
  "headless": true
}

Output

The default dataset contains one item per organic search result. The following are the most useful fields; rich-result, rating, price, date, and media fields appear only when Ecosia exposes them.

Field	Type	Description
position	integer	Position
title	string	Title
description	string	Description
link	string	Result Link
domain	string	Domain
displayUrl	string	Display URL
page	integer	Page
searchQuery	string	Search Query
scrapedAt	string	Scraped At
type	string	Type
snippet	string	Snippet
url	string	URL
source	string	Source
query	string	Query
resultType	string	Result Type
titleHtml	string	Title HTML

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "title": "Artificial intelligence - Wikipedia",
  "description": "Artificial intelligence (AI) is the capability of computational systems to perform tasks typically associated with human intelligence",
  "link": "https://en.wikipedia.org/wiki/Artificial_intelligence",
  "domain": "en.wikipedia.org",
  "displayUrl": "https://en.wikipedia.org/wiki/Artificial_intelligence",
  "page": 1,
  "searchQuery": "artificial intelligence",
  "scrapedAt": "2026-07-23T18:22:14.831Z",
  "type": "organic",
  "snippet": "Artificial intelligence (AI) is the capability of computational systems to perform tasks typically associated with human intelligence",
  "url": "https://en.wikipedia.org/wiki/Artificial_intelligence"
}

Related Actors

• Ecosia Images Scraper
• Ecosia News Scraper
• Ecosia Videos Scraper