Ecosia Images Scraper

Scrapes normalized image search results from Ecosia.

What this Actor collects

The Actor converts Ecosia image results into one clean JSON record per image, including original and preview URLs, source page and domain, dimensions, format, safety and ranking metadata, page position, locale, and retrieval provenance when available.

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

Use cases

• Visual research
• Image-source discovery
• Media and asset 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	"climate change"	Keywords to search for images on Ecosia.
maxItems	integer	No	25 (maximum 100)	Maximum image records to save.
maxPages	integer	No	1 (maximum 10)	Maximum Ecosia result pages to inspect.
region	string	No	"us-en"	Country-language code used for browser locale and result metadata.
proxyConfiguration	object	No	{"useApifyProxy":false}	Optional Apify Proxy configuration for blocked hosted requests.
maxRequestRetries	integer	No	3	Retries blocked or failed pages with rotated sessions.
requestTimeoutSecs	integer	No	90	Maximum seconds for extracting one page.
navigationTimeoutSecs	integer	No	60	Maximum seconds for browser navigation.
headless	boolean	No	true	Run Chrome without a visible window.

Example input

{
  "query": "climate change",
  "maxItems": 50,
  "maxPages": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "region": "us-en",
  "maxRequestRetries": 3,
  "requestTimeoutSecs": 90,
  "navigationTimeoutSecs": 60,
  "headless": true
}

Output

The default dataset contains one item per image result. The following are the most useful fields; dimensions, file details, dates, licensing, and other media metadata appear only when Ecosia exposes them.

Field	Type	Description
position	integer	Position
title	string	Title
imageUrl	string	Original Image URL
thumbnailUrl	string	Thumbnail URL
sourcePageUrl	string	Source Page URL
sourceDomain	string	Source Domain
width	integer	Original Width
height	integer	Original Height
fileFormat	string	File Format
page	integer	Page
searchQuery	string	Search Query
scrapedAt	string	Scraped At
type	string	Type
url	string	URL
source	string	Source
query	string	Query

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": "What is climate change? A really simple guide - BBC News",
  "imageUrl": "https://ichef.bbci.co.uk/news/976/cpsprodpb/2B08/production/_127561011_climate_5_cc_index_and_article_image_template_976-ncclimate_change_article_image_template_976-nc.png",
  "thumbnailUrl": "https://tse2.mm.bing.net/th/id/OIP.sA2Y7f1OFhWEEG5DrdPpIgHaEL?r=0&pid=Api",
  "sourcePageUrl": "https://www.bbc.com/news/science-environment-24021772?s=35",
  "sourceDomain": "bbc.com",
  "width": 976,
  "height": 550,
  "fileFormat": "png",
  "page": 1,
  "searchQuery": "climate change",
  "scrapedAt": "2026-07-23T17:59:13.759Z"
}

Related Actors

• Ecosia News Scraper
• Ecosia Search Scraper
• Ecosia Videos Scraper