DuckDuckGo Images Scraper

Scrapes image search results from DuckDuckGo Images. Extracts image URL, thumbnail, alt text, dimensions, format, file size, dominant color, source domain, favicon, creator, license, and more.

What this Actor collects

The Actor converts DuckDuckGo Images results into one clean JSON record per image, including original and thumbnail URLs, dimensions, format, source page and domain, publication metadata when available, applied filters, and search provenance.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 40-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	"cats"	The search query for DDG image search.
maxItems	integer	No	100	Maximum number of images to scrape.
region	string	No	"us-en"	DDG region code (e.g. us-en, uk-en, de-de).
size	string	No	""	Filter by image size.
color	string	No	""	Filter by dominant color.
type	string	No	""	Filter by image type.
layout	string	No	""	Filter by image aspect ratio.
license	string	No	""	Filter by usage license.
safeSearch	string	No	"moderate"	Safe search setting.
maxRequestRetries	integer	No	2	Retries for transient navigation failures and rate limits.
navigationTimeoutSecs	integer	No	45	Maximum time in seconds for each search navigation.
headless	boolean	No	true	Run Firefox without a visible window.
proxyConfiguration	object	No	{"useApifyProxy":true}	Proxy settings.

Example input

{
  "query": "artificial intelligence",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "region": "us-en",
  "safeSearch": "moderate"
}

Output

The default dataset contains one item per image result. The following are the most useful fields; dimensions, format, dates, and other media metadata appear only when supplied by the source response.

Field	Type	Description
position	integer	Position
thumbnail	string	Thumbnail
title	string	Title
imageUrl	string	Image URL
imageWidth	integer	Image Width
imageHeight	integer	Image Height
fileFormat	string	File Format
sourceDomain	string	Source Domain
sourceUrl	string	Source URL
searchQuery	string	Search Query
region	string	Region
safeSearch	string	Safe Search
scrapedAt	string	Scraped At
type	string	Record Type
query	string	Query
resultType	string	Result Type

Example dataset item

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

{
  "position": 1,
  "thumbnail": "https://tse3.mm.bing.net/th/id/OIP.4OEXlgSo030JWa8WUpS_UAHaE8?r=0&pid=Api",
  "title": "iAsk Student · ai",
  "imageUrl": "https://incubator.ucf.edu/wp-content/uploads/2023/07/artificial-intelligence-new-technology-science-futuristic-abstract-human-brain-ai-technology-cpu-central-processor-unit-chipse…",
  "imageWidth": 1500,
  "imageHeight": 1000,
  "fileFormat": "jpeg",
  "sourceDomain": "iask.ai",
  "sourceUrl": "https://iask.ai/q?q=ai",
  "searchQuery": "artificial intelligence",
  "region": "us-en",
  "safeSearch": "moderate"
}

Related Actors

• Duck.ai Guest Answers Scraper
• DuckDuckGo Autocomplete Scraper
• DuckDuckGo Bangs Directory Scraper