# Web Images Scraper (`maximedupre/web-images-scraper`) Actor Extract image URLs from public webpages, domains, and direct image links. Get source pages, discovery methods, metadata, and optional saved files or ZIP archives. - **URL**: https://apify.com/maximedupre/web-images-scraper.md - **Developed by:** [Maxime Duprรฉ](https://apify.com/maximedupre) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $6.30 / 1,000 processed image urls This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### ๐Ÿ–ผ๏ธ What is Web Images Scraper? **Web Images Scraper** extracts image URLs from public webpages, domains, and direct image links. Use it to find webpage images, responsive `srcset` candidates, Open Graph images, icons, CSS background images, and optional saved image files without opening each page by hand. Start with the prefilled [Wikimedia Commons](https://commons.wikimedia.org/wiki/Main_Page) example or paste your own public website URL. Keep downloads off for a quick metadata-only run, then enable image saving or ZIP archives when you need files in Apify key-value storage. ### ๐Ÿ”Ž What can Web Images Scraper do? - Extract images from `img` tags, `srcset`, page metadata, icons, inline styles, and linked stylesheets. - Accept public webpage URLs, bare domains, and direct image URLs. - Crawl same-domain links when you raise the crawl depth and page limit. - Filter images by file extension, minimum known byte size, and URL text. - Save one dataset item per accepted image as soon as it is accepted. - Optionally download images and create one ZIP archive per input target. - Export results through Apify datasets, API, webhooks, schedules, and integrations. ### ๐Ÿ“ฆ What data can it extract? | Data point | What it means | | --- | --- | | Input URL | The webpage, domain, or direct image URL you submitted. | | Source page URL | The page where the image was discovered. | | Image URL | The original image URL found on the page. | | Normalized image URL | A cleaned absolute URL for matching and exports. | | Filename and extension | File naming details when they can be inferred. | | Content type and file size | Metadata from the image response when available. | | Alt and title text | Nearby accessibility and title text from the page. | | Discovery method | Whether the image came from `img`, `srcset`, metadata, CSS, or a direct URL. | | Crawl details | Page index, crawl depth, source order, and scrape timestamp. | | Saved file links | Apify storage links when image downloads are enabled. | | ZIP file links | Archive metadata when ZIP creation is enabled. | ### ๐Ÿงญ How do I scrape images from a website? 1. Add one or more public webpage URLs, domains, or direct image URLs. 2. Choose how many images to keep per page. 3. Keep `Crawl depth` at `0` for only the submitted page, or raise it to follow same-domain links. 4. Leave discovery options enabled unless you want to exclude `srcset`, metadata, or CSS background images. 5. Turn on `Save image files to Apify storage` if you need downloadable files. 6. Turn on `Create ZIP files` only when downloads are enabled and you want one archive per input target. 7. Run the Actor and export the dataset as JSON, CSV, Excel, XML, or through the Apify API. ### โš™๏ธ Input options The main input is `Webpage or image URLs`. You can paste values such as: ```json [ { "url": "https://www.python.org/" }, { "url": "https://www.python.org/static/img/python-logo.png" } ] ```` Use `Max images per page` to cap how many image rows are saved from each page. Use `Max pages per input` and `Crawl depth` together when you want a small same-domain crawl instead of a single-page extraction. The filter options are useful for bulk image downloader workflows. For example, keep only `png` and `webp` extensions, require image URLs to contain `/uploads/`, or exclude URLs containing `logo` or `icon`. Images without a known byte size are kept unless another filter removes them. ### ๐Ÿงพ Output example Each dataset item is one accepted image: ```json { "inputIndex": 0, "inputUrl": "https://www.python.org/", "sourcePageUrl": "https://www.python.org/", "imageUrl": "https://www.python.org/static/img/python-logo.png", "normalizedImageUrl": "https://www.python.org/static/img/python-logo.png", "filename": "python-logo.png", "extension": "png", "contentType": "image/png", "fileSizeBytes": 15782, "width": null, "height": null, "altText": "python logo", "titleText": null, "discoveryMethod": "img-src", "sourceOrder": 1, "pageIndex": 1, "crawlDepth": 0, "isDirectImage": false, "duplicateKey": "a1b2c3", "scrapedAt": "2026-06-04T00:00:00.000Z" } ``` When downloads are enabled, rows also include `downloadUrl` and `savedFile`. When ZIP archives are enabled, rows also include `zipFile`. ### ๐Ÿ’ณ How much does Web Images Scraper cost? This Actor uses pay-per-event pricing. You are charged for each input webpage or direct image URL that is successfully processed for image extraction, not for every image row saved. For lower-cost first tests, run one or two targets with downloads disabled. Enabling downloads and ZIP archives can use more storage and runtime because the Actor has to fetch and save each accepted image file. ### โš ๏ธ Limits and caveats Web Images Scraper is for public webpages and public image URLs. It does not log in, use cookies, submit forms, bypass private content, or search Google Images. Some websites block automated traffic, return temporary errors, lazy-load images in ways that are not present in the page HTML, or hide assets behind scripts that are not exposed as normal image URLs. The Actor uses Apify Proxy by default. Invalid, blocked, or empty targets are handled gracefully, so one difficult website does not have to fail the whole run. ### โ“ FAQ #### Can it download all images from a website? It can crawl same-domain links up to your selected depth and page limit, then save accepted images from those pages. Keep the first run small, review the output, and raise limits only when the results match what you need. #### Can I use direct image URLs? Yes. A direct image URL is accepted as an input target and saved as one image row. If downloads are enabled, the file can also be saved to Apify storage. #### Does it include CSS background images? Yes, when `Include CSS background images` is enabled. It checks inline styles and linked stylesheets for image URLs. #### Does it preserve duplicate images? The output includes a `duplicateKey` so equivalent image URLs can be recognized in exports. The Actor keeps one accepted row for each discovered image identity in the run. ### ๐Ÿ“ Changelog - 0.0: Initial release. ### ๐Ÿ†˜ Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~web-images-scraper/issues) and I'll fix or implement it in less than 24h ๐Ÿซก ### ๐Ÿ”— Other actors - [Website URL Crawler โ†—](https://apify.com/maximedupre/website-url-crawler) - crawl websites and export discovered URLs for audits or crawl planning. - [Unsplash Image Scraper โ†—](https://apify.com/maximedupre/unsplash-image-scraper) - scrape Unsplash image search results by keyword. - [Twitter Media Scraper โ†—](https://apify.com/maximedupre/twitter-media-scraper) - extract public X/Twitter image, video, and GIF URLs. - [Facebook Media Downloader โ†—](https://apify.com/maximedupre/facebook-media-downloader) - download public Facebook videos and reels. - [Instagram Downloader API โ†—](https://apify.com/maximedupre/instagram-downloader-api) - extract media URLs from public Instagram posts and reels. **Made with โค๏ธ by Maxime Duprรฉ** # Actor input Schema ## `startUrls` (type: `array`): Add public webpages, domains, or direct image URLs. Domains like example.com are accepted and normalized to HTTPS. ## `maxImagesPerPage` (type: `integer`): Maximum accepted images to save from each webpage before moving to the next page. ## `maxPagesPerStartUrl` (type: `integer`): Maximum webpages to open for each input URL when crawling is enabled. ## `crawlDepth` (type: `integer`): How many same-domain link levels to follow from each input page. Use 0 to extract images only from the submitted page. ## `includeSrcset` (type: `boolean`): Extract responsive image candidates from srcset attributes. ## `includeCssBackgrounds` (type: `boolean`): Extract image URLs from inline styles and linked stylesheets. ## `includeMetadataImages` (type: `boolean`): Extract Open Graph, Twitter Card, and icon image URLs from page metadata. ## `downloadImages` (type: `boolean`): Download each accepted image and add Apify storage links to the output. ## `zipDownloads` (type: `boolean`): When image saving is enabled, also create one ZIP archive per input URL and link it from each image. ## `minImageBytes` (type: `integer`): Skip images with a known byte size below this value. Images without known size are kept. ## `allowedExtensions` (type: `array`): Image file extensions to keep. Leave the default list for broad webpage image extraction, or narrow it to formats like png and webp. ## `includeUrlPatterns` (type: `array`): Optional text filters. When set, an image URL must contain at least one value. ## `excludeUrlPatterns` (type: `array`): Optional text filters for image URLs to skip. ## `proxyConfiguration` (type: `object`): Apify Proxy settings used to load webpages and images. Keep the default unless the target site needs a specific proxy setup. ## Actor input object example ```json { "startUrls": [ { "url": "https://commons.wikimedia.org/wiki/Main_Page" } ], "maxImagesPerPage": 100, "maxPagesPerStartUrl": 1, "crawlDepth": 0, "includeSrcset": true, "includeCssBackgrounds": true, "includeMetadataImages": true, "downloadImages": false, "zipDownloads": false, "minImageBytes": 1024, "allowedExtensions": [ "jpg", "jpeg", "png", "gif", "webp", "svg", "bmp", "ico", "avif" ], "includeUrlPatterns": [], "excludeUrlPatterns": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): Open the dataset with image URLs, source pages, discovery methods, optional saved file links, and scrape metadata. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://commons.wikimedia.org/wiki/Main_Page" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/web-images-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://commons.wikimedia.org/wiki/Main_Page" }] } # Run the Actor and wait for it to finish run = client.actor("maximedupre/web-images-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://commons.wikimedia.org/wiki/Main_Page" } ] }' | apify call maximedupre/web-images-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/web-images-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Web Images Scraper", "description": "Extract image URLs from public webpages, domains, and direct image links. Get source pages, discovery methods, metadata, and optional saved files or ZIP archives.", "version": "0.0", "x-build-id": "d2Px0NuT1ScdmRCZx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~web-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-web-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/maximedupre~web-images-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-web-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/maximedupre~web-images-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-web-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Webpage or image URLs", "minItems": 1, "maxItems": 100, "type": "array", "description": "Add public webpages, domains, or direct image URLs. Domains like example.com are accepted and normalized to HTTPS.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Public webpage, bare domain, or direct image URL.", "minLength": 1 } }, "required": [ "url" ] } }, "maxImagesPerPage": { "title": "Max images per page", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum accepted images to save from each webpage before moving to the next page.", "default": 100 }, "maxPagesPerStartUrl": { "title": "Max pages per input", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum webpages to open for each input URL when crawling is enabled.", "default": 1 }, "crawlDepth": { "title": "Crawl depth", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many same-domain link levels to follow from each input page. Use 0 to extract images only from the submitted page.", "default": 0 }, "includeSrcset": { "title": "Include responsive images", "type": "boolean", "description": "Extract responsive image candidates from srcset attributes.", "default": true }, "includeCssBackgrounds": { "title": "Include CSS background images", "type": "boolean", "description": "Extract image URLs from inline styles and linked stylesheets.", "default": true }, "includeMetadataImages": { "title": "Include page metadata images", "type": "boolean", "description": "Extract Open Graph, Twitter Card, and icon image URLs from page metadata.", "default": true }, "downloadImages": { "title": "Save image files to Apify storage", "type": "boolean", "description": "Download each accepted image and add Apify storage links to the output.", "default": false }, "zipDownloads": { "title": "Create ZIP files", "type": "boolean", "description": "When image saving is enabled, also create one ZIP archive per input URL and link it from each image.", "default": false }, "minImageBytes": { "title": "Minimum image size", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Skip images with a known byte size below this value. Images without known size are kept.", "default": 1024 }, "allowedExtensions": { "title": "Allowed extensions", "type": "array", "description": "Image file extensions to keep. Leave the default list for broad webpage image extraction, or narrow it to formats like png and webp.", "items": { "type": "string" }, "default": [ "jpg", "jpeg", "png", "gif", "webp", "svg", "bmp", "ico", "avif" ] }, "includeUrlPatterns": { "title": "Only include URLs containing", "type": "array", "description": "Optional text filters. When set, an image URL must contain at least one value.", "items": { "type": "string" }, "default": [] }, "excludeUrlPatterns": { "title": "Exclude URLs containing", "type": "array", "description": "Optional text filters for image URLs to skip.", "items": { "type": "string" }, "default": [] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings used to load webpages and images. Keep the default unless the target site needs a specific proxy setup.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```