Website Image Downloader & Scraper

Effortlessly crawl any website, discover all embedded images, and download them all bundled into a single images.zip file alongside rich metadata.

Whether you are building AI training datasets, archiving e-commerce product photos, collecting design inspiration, or extracting visual assets for marketing, Website Image Downloader automates the entire process in just a few clicks.

---

Key Features

• One-Click ZIP Download: Automatically bundles all downloaded images into a single images.zip file saved in your Key-Value Store. No need to download files one by one!
• Deep Website Crawling: Set your desired crawl depth (0 to 5) to follow internal links and discover images across the entire website.
• High Concurrency & Fast Performance: Processes multiple pages and image downloads in parallel with up to 50 concurrent connections.
• Format Filtering: Filter by specific extensions (.jpg, .jpeg, .png, .gif, .webp, .bmp, .svg).
• Domain Scoping: Restrict crawling strictly to specific domain lists or include subdomains.
• Proxy & Anti-Blocking Support: Built-in support for Apify Proxy and custom User-Agent headers to prevent IP blocks.
• Rich Dataset Metadata: Export clean JSON/CSV dataset listing every image's source page, original URL, file size, content type, and key.

---

Quick Start Guide (Apify Console)

Follow these simple steps to start downloading images in under 2 minutes:

1. Click "Try for free" or open the Actor in the Apify Console.
2. Enter the Start URL: Provide the website homepage or gallery link you want to extract images from.
3. Configure Settings (Optional):
   • Adjust Maximum Crawl Depth (Default: 1 for following links to direct subpages).
   • Select Image Extensions to filter out unwanted formats.
   • Enable Apify Proxy for smooth scraping without getting blocked.
4. Click "Start" to launch the run.
5. Download Your Images:
   • Go to the Storage tab.
   • Under Key-Value Store, click images.zip to download all images at once!
   • Under Dataset, export metadata as JSON, CSV, or Excel.

---

Input Parameters

Here is a quick overview of the main input options available:

Parameter	Type	Default	Description
startUrl (Required)	String	""	The target website URL to start crawling from (e.g. https://example.com).
maxCrawlDepth	Integer	1	Depth of links to follow. 0 = Start URL only, 1 = Start URL + direct links, up to 5.
maxConcurrency	Integer	20	Number of parallel page/image downloads (1 - 50).
imageExtensions	Array	["jpg", "jpeg", "png", "gif", "webp", "bmp", "svg"]	List of allowed image extensions to scrape.
useScope	Boolean	false	Restrict crawling exclusively to specified domains.
scope	Array	[]	List of allowed domain names when useScope is enabled.
includeSubdomains	Boolean	false	When scoping, also include subdomains (e.g. blog.example.com).
respectRobotsTxt	Boolean	true	Respect robots.txt crawler rules.
userAgent	String	Mozilla/5.0...	Custom HTTP User-Agent header string.
proxyConfiguration	Object	{ "useApifyProxy": true }	Apify Proxy settings to prevent blocking.

Minimal Input Example (JSON)

{
  "startUrl": "https://example.com/gallery",
  "maxCrawlDepth": 1,
  "imageExtensions": ["jpg", "jpeg", "png", "webp"],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

---

Output Formats

Upon completion, the Actor generates two main storage outputs:

1. Key-Value Store (Image Files & ZIP Archive)

• images.zip: A compressed ZIP file containing every downloaded image, ready for single-click download.
• image-00001.jpg, image-00002.png, ...: Individual image files stored under unique sequential keys.

2. Dataset (Metadata Log)

Each entry in the dataset contains detailed metadata for each processed image:

{
  "imageUrl": "https://example.com/images/photo1.jpg",
  "sourcePage": "https://example.com/gallery",
  "foundAt": "https://example.com/gallery",
  "key": "image-00001.jpg",
  "contentType": "image/jpeg",
  "sizeBytes": 245890
}

---

Use Cases

• E-Commerce Catalog Archiving: Download all product photos from online stores for inventory or competitive analysis.
• AI & Machine Learning Datasets: Gather thousands of categorized web images for model training (computer vision, dataset generation).
• Creative Asset Collection: Rapidly pull moodboards, stock photos, and media assets for marketing campaigns and UI design.
• Website Backups & Migration: Archive visual content before website redesigns or platform migrations.

---

Performance & Cost Optimization

• Low RAM Requirement: Runs efficiently on just 512 MB memory, making it extremely cost-effective.
• Fast Downloading: Leverages async HTTP streaming and parallel workers for maximum speed.
• Proxy Efficiency: Works smoothly with standard Apify datacenter proxies.

---

Frequently Asked Questions (FAQ)

---

Support & Feedback

If you encounter any issues, have feature requests, or need help customizing your run, feel free to submit an issue via the Issues tab on the Apify Actor page.