DuckDuckGo Images Scraper

Search public DuckDuckGo Images results and collect clean, source-backed image metadata through DuckDuckGo's structured image-data endpoint.

Highlights

• One primary query plus up to 19 additional queries
• Fair per-query caps and interleaved global output
• DuckDuckGo region, Safe Search, size, color, type, layout, and license filters
• Bounded pagination, concurrency, retries, and timeouts
• Direct access by default, with authorized Residential/custom proxy support
• Stable query-specific IDs, recursive empty-value omission, and no raw transport payloads or opaque tokens

The Actor first loads the public DuckDuckGo search page to obtain the current image-search token, then requests the same structured image data used by the website. It validates HTTP status, content type, and payload shape before parsing. CAPTCHA/challenge pages fail closed and are never stored.

Example

{
  "query": "artificial intelligence",
  "queries": ["robotics"],
  "maxItems": 20,
  "maxItemsPerQuery": 10,
  "maxPages": 2,
  "region": "us-en",
  "size": "Large",
  "color": "Blue",
  "type": "photo",
  "layout": "Wide",
  "safeSearch": "moderate",
  "maxConcurrency": 2,
  "proxyConfiguration": { "useApifyProxy": false }
}

Output

Each record can include:

• Stable identity and ranking: id, position, queryPosition, globalPosition, pagePosition, page
• Image: imageUrl, thumbnailUrl, numeric width/height, aspectRatio, orientation, fileFormat, mimeType, isAnimated
• Source: sourceUrl, sourceDomain, sourceTitle
• Context: searchQuery, searchUrl, region, country, language, market, Safe Search and requested filters
• Provenance: dataSource, retrievalMethod, discoveredAt, scrapedAt

Unavailable optional fields are omitted rather than emitted as null, empty strings, or fabricated placeholders. The API's opaque image and thumbnail transport tokens are intentionally not stored.

Notes

• Result availability and ranking are controlled by DuckDuckGo.
• Filter values are sent to DuckDuckGo exactly as represented in the input and are repeated in each output record when selected.
• Image copyright and license decisions remain the consumer's responsibility; the Actor records the requested license filter but does not invent per-image license metadata that DuckDuckGo does not return.