Ecosia Videos Scraper

Scrapes normalized video search results from Ecosia.

What this Actor collects

The Actor converts Ecosia video results into one clean JSON record per video, including video and embed URLs, channel or publisher, duration and view data, publication time, thumbnails, platform, page position, locale, and search provenance when available.

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

Use cases

• Video discovery
• Publisher and topic monitoring
• Media-catalog 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 for videos on Ecosia.
maxItems	integer	No	25	Maximum number of complete, unique video records to save.
maxPages	integer	No	3	Maximum number of Ecosia video-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": 25,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "region": "us-en",
  "maxRequestRetries": 3,
  "requestTimeoutSecs": 90,
  "navigationTimeoutSecs": 60,
  "headless": true
}

Output

The default dataset contains one item per video result. The following are the most useful fields; engagement, channel, date, resolution, and embed metadata depend on the source response.

Field	Type	Description
position	integer	Position
title	string	Title
url	string	Video URL
thumbnailUrl	string	Thumbnail URL
channel	string	Channel
duration	string	Duration
viewCount	integer	View Count
publishedAtRaw	string	Published At Raw
platform	string	Platform
page	integer	Page
searchQuery	string	Search Query
scrapedAt	string	Scraped At
type	string	Type
description	string	Description
snippet	string	Snippet
link	string	Video Link

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": "Elon Musk: AI will be smarter than humans in five years | The Economist",
  "url": "https://www.youtube.com/watch?v=qOpM0Ar_0OY",
  "thumbnailUrl": "https://i.ytimg.com/vi/qOpM0Ar_0OY/hqdefault.jpg",
  "duration": "02:23",
  "publishedAtRaw": "July 23, 2026",
  "platform": "YouTube",
  "page": 1,
  "searchQuery": "artificial intelligence",
  "scrapedAt": "2026-07-23T18:31:48.015Z",
  "type": "video",
  "description": "“There really won't be anything that AI can’t do better than humans, apart from being human, perhaps” says Elon Musk. On the latest Insider, he tells Zanny Minton Beddoes, The Eco…"
}

Related Actors

• Ecosia Images Scraper
• Ecosia News Scraper
• Ecosia Search Scraper