# Bulk Image Downloader API: Save Page Images with Sizes (`rowcraft/bulk-image-downloader`) Actor Download the images of any web pages, or direct image links, into a key-value store with width, height, format, size and a download link per file. Tracking pixels are skipped, robots.txt obeyed, pay only for images saved. - **URL**: https://apify.com/rowcraft/bulk-image-downloader.md - **Developed by:** [Rowcraft](https://apify.com/rowcraft) (community) - **Categories:** Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 images 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Bulk Image Downloader API: Save Page Images with Sizes Bulk Image Downloader saves the pictures of any list of **web pages** into the key-value store of your run and tells you, for every file, its width, height, format, size in bytes, SHA-1 and a download link. Give it page addresses, direct image links, or both; it finds the images in each page's HTML, downloads them politely one by one, skips tracking pixels and icons with a size filter, and returns one row per image saved, as JSON, CSV or Excel, with the files next to the rows. No browser is started and no JavaScript is run: the actor reads the HTML a page sends, as a plain visitor would. That keeps a run fast and cheap, and it means pictures that a page only builds later with JavaScript are not seen (see Limits). ![Input form of Bulk Image Downloader API: Save Page Images with Sizes](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/bulk-image-downloader-input.png) ### What you get One row per image **saved**: - **Where it came from:** the address of the image (`imageUrl`), the page it was found on (`pageUrl`, null for a direct link) and how it was found (`source`: `img`, `srcset`, `picture`, `og`, `link`, `css` or `direct`) - **What it is:** width and height in pixels, format (`jpeg`, `png`, `gif`, `webp`, `avif`, `svg`, `bmp`, `ico`, `tiff`) and size in bytes, all read from the file's own header, never guessed from the address - **A fingerprint:** the SHA-1 of the file, so identical pictures under different addresses can be spotted and removed - **The file itself:** saved in the run's key-value store under `fileKey` (a readable name from the address plus ten characters of the hash, for example `a-light-in-the-attic-fe72f05323.jpg`), with a `downloadUrl` that opens it - **The alt text** of the image, when the page has one, with e-mail addresses, phone numbers and contact names next to a cue removed - **When:** `savedAt`, the time the file was saved The run also writes two records in the key-value store: `COVERAGE` (one line per page and one per image that was **not** saved, with the reason) and `RUN_SUMMARY` (counts, the filters used, bytes stored, why the run stopped). ### Why this actor - **You pay per image saved, not per page.** Leaders in this niche charge per page processed, whatever the page holds. Here a page with 30 images costs $0.06 at the Free price and $0.045 at the Business price, a page with 8 images costs $0.016, and a page with no usable image costs nothing. - **Junk is free.** Tracking pixels, spacers, icons and anything below your minimum width and height are not saved and not charged. The default minimum is 100 x 100 px. - **One file per picture, not three.** Modern pages list the same photo at several widths and formats. By default you get the largest listed version once; turn on **Save every listed size of a picture** to get them all. - **Duplicates are free.** An address handled twice, or two addresses with the same content (SHA-1), count once. - **Sizes from the file.** Width, height and format come from the image header, so a `.jpg` that is really a WebP is reported as `webp`. - **Polite by design.** robots.txt is read and obeyed on the page host and on the image host (a CDN has its own), one request per second per host by default, a site's Crawl-delay is honoured up to 10 seconds, no proxies, no CAPTCHA solving. - **Fits small runs.** The actor runs in 256 MB; a 14 MB image was saved in a test with a peak of about 130 MB. ### How to use it 1. Open the Actor and fill in **Page URLs** (the other fields are optional filters). 2. Set **Maximum images** to a small number for a first try (the default is a safe start). 3. Click **Start**. The status line shows progress; the run stops cleanly at your limit or at the charge limit you set in the run options. 4. Open the **Dataset** tab and download JSON, CSV, Excel, XML or HTML, or send the rows to Google Sheets, Slack, Make, n8n or Zapier with the Integrations tab. 5. To run it on a schedule, use **Schedules** in Apify Console and turn on **Only new rows since the last run** below: every run then costs only the new rows, and a webhook URL tells you when something new came in. A few practical notes: - Put pages in **Page URLs** and files in **Direct image URLs**; the same run can take both. - For a first try, keep the list short and leave the filters at their defaults. - The files are in the **Storage** tab of the run, in the key-value store. Each row's `fileKey` is the record key. - To collect a gallery, tick **Also take links to image files**: thumbnails often link to the full-size picture. ### Input | Field | What it does | |---|---| | `urls` | Pages to collect the images of, one address per line. A bare domain is read as `https://`. | | `imageUrls` | Direct links to image files, one per line (optional). | | `minWidth`, `minHeight` | Smallest image saved, in pixels. Default 100 x 100. 0 turns the filter off. | | `formats` | Save only these formats. Empty = all. | | `maxImagesPerPage` | Stop reading a page after this many images were saved from it. Default 100. | | `maxItems` | Stop the whole run after this many images were saved. Default 500, 0 = no limit. | | `allSizes` | Save every listed size and format of a picture, not only the largest. Default off. | | `includeLinkedImages` | Also take links to image files (``). Default off. | | `includeBackgroundImages` | Also take inline CSS `background-image`. Default off. | | `dedupe` | Skip repeated addresses and files with the same content. Default on. | | `maxImageSizeMb` | Largest file saved, default 15 MB, maximum 30. Larger files are not saved. | | `includeAltText` | Deliver the alt text. Default on. | | `onlyNew`, `stateName` | Save an image again only when its content changed since the last run with the same state name | | `notifyUrl`, `notifyWhenEmpty` | A webhook that receives one message when the run ends; see **Automation** below | | `requestIntervalMs` | Pause between requests to the same host, default 1000 ms, minimum 250 ms | Example: the product photos of two pages, large images only. ```json { "urls": [ "https://shop.example.com/products/chair", "https://shop.example.com/products/table" ], "minWidth": 400, "minHeight": 400, "formats": ["jpeg", "webp"] } ``` Example: download a list of image links you already have. ```json { "imageUrls": [ "https://cdn.example.com/photos/1.jpg", "https://cdn.example.com/photos/2.png" ] } ``` #### Where the actor looks for images - ``, and the lazy-loading attributes `data-src`, `data-lazy-src` and `data-original` that many shops use instead of a real `src` - `srcset` of an image and of the `` tags inside ``: by default the largest width listed (or the highest pixel density) is taken - the `og:image` preview picture of the page - on request, links to image files and inline CSS backgrounds - never: `data:` pictures embedded in the HTML (they are counted as skipped), favicons, pictures drawn by JavaScript, videos, and anything in `mailto:`, `tel:` or `sms:` links ### Output 13 fields per row. Empty values are `null`, never missing, so CSV and Excel columns are stable. | Field | Type | Example | |---|---|---| | `imageUrl` | string | `https://books.toscrape.com/media/cache/fe/72/fe72f0532301ec28892ae7…` | | `pageUrl` | string | `https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/inde…` | | `alt` | string | A Light in the Attic | | `width` | integer | 318 | | `height` | integer | 395 | | `format` | string | jpeg | | `bytes` | integer | 31047 | | `sha1` | string | 3e7b0b8c3a2c9f6c2f6e8f4c6b1a5d9e0f7a1b2c | | `fileKey` | string | fe72f0532301ec28892ae79a629a293c-3e7b0b8c3a.jpg | | `downloadUrl` | string | `https://api.apify.com/v2/key-value-stores/XXXX/records/fe72f0532301…` | | `source` | string | img | | `savedAt` | string | 2026-10-17T09:30:00.000Z | | `error` | string | Always null for a saved image; images that could not be saved are listed in COVERAGE, never as rows | #### Example rows Two real rows from a run (long texts shortened here, complete in the dataset): ```json [ { "imageUrl": "https://books.toscrape.com/media/cache/fe/72/fe72f0532301ec28892ae79a629a293c.jpg", "pageUrl": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "alt": "A Light in the Attic", "width": 318, "height": 395, "format": "jpeg", "bytes": 31047, "sha1": "ec691a9dc9ff1e9eec0904f7d5fb0207e48d5db1", "fileKey": "fe72f0532301ec28892ae79a629a293c-ec691a9dc9.jpg", "downloadUrl": "https://api.apify.com/v2/key-value-stores/57d6416e-fe16-4060-b8a2-56d35d758db0/records/fe72f0532301ec28892ae79a629a293c-ec691a9dc9.jpg", "source": "img", "savedAt": "2026-10-17T08:22:08.992Z", "error": null }, { "imageUrl": "https://www.wikipedia.org/portal/wikipedia.org/assets/img/Wikipedia-logo-v2%402x.png", "pageUrl": "https://www.wikipedia.org/", "alt": null, "width": 400, "height": 366, "format": "png", "bytes": 37479, "sha1": "35663f1be7a10d804a127b3cc12291394968541f", "fileKey": "Wikipedia-logo-v2-2x-35663f1be7.png", "downloadUrl": "https://api.apify.com/v2/key-value-stores/57d6416e-fe16-4060-b8a2-56d35d758db0/records/Wikipedia-logo-v2-2x-35663f1be7.png", "source": "srcset", "savedAt": "2026-10-17T08:21:59.203Z", "error": null } ] ``` Results can be downloaded as JSON, CSV, Excel, XML or HTML from the Dataset tab, or read through the Apify API. ![Results of Bulk Image Downloader API: Save Page Images with Sizes in the Apify dataset view](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/bulk-image-downloader-results.png) The `downloadUrl` is a link to the file in the run's key-value store. On the Apify platform it carries a signature, so it opens without logging in for as long as the file exists. ### Pricing **Pay per result.** You pay for each image saved and delivered to your dataset, nothing else: no subscription, no minimum, no charge for images your filters drop, for duplicates, for failed or refused downloads, or for the requests behind them. | Your Apify plan | Price per 1,000 images | Price per image | |---|---|---| | Free plan | **$2.00** | $0.002 | | Starter plan | **$1.80** | $0.0018 | | Scale plan | **$1.60** | $0.0016 | | Business plan and above | **$1.50** | $0.0015 | Example: 1,000 images cost $2.00 on the Free plan and $1.50 on the Business plan. A start event of $0.00005 is charged once per run (Apify default). **Platform usage is separate.** Apify bills the compute of the run (it runs in 256 MB and spends most of its time waiting between requests, about one image per second per host) and the storage of the saved files, as for every Actor; it is not part of the price above. **Cap your spend:** set *Maximum total charge* in the run options. The actor stops cleanly when the cap is reached and you keep everything saved until then. The run summary (`RUN_SUMMARY` in the key-value store) says why a run stopped. **What a page costs.** The price is per image saved, so the cost of a page follows its content: | Images saved from the page | Free plan | Business plan | |---|---|---| | 1 | $0.002 | $0.0015 | | 8 | $0.016 | $0.012 | | 30 | $0.06 | $0.045 | | 100 | $0.20 | $0.15 | Tools in this niche that charge per page processed list $0.056 to $0.07 per page on their Free plan, whatever the page holds. Per image, this actor is cheaper from the first page that holds fewer than 28 saved images. Storing the files uses Apify storage, billed with the platform usage of the run: a run that saves 1,000 images of 150 KB keeps 150 MB in the key-value store. ### Automation: only new rows, notifications, schedules **Only new rows since the last run.** Turn on `onlyNew` and the actor remembers every image it delivered to you (in a key-value store named `rowcraft-bulk-image-downloader-state` in your Apify account). The next run with the same `stateName` skips what you already have and you pay only for new rows. The first run delivers everything that matches. Use a different `stateName` for each schedule or search so they keep separate memories. **Notification when the run ends.** Put a webhook address in `notifyUrl` and the actor sends one JSON POST with the number of new rows, links to the dataset (JSON and CSV) and the run. It works out of the box with Slack and Discord incoming webhooks (the message is in `text` and `content`), with Make, n8n and Zapier catch hooks, and with your own endpoint. By default it is sent only when there is at least one new row; `notifyWhenEmpty` sends it every time. **Schedules.** Create a schedule in Apify Console (hourly, daily, weekly or cron) with `onlyNew` on. A daily schedule gives you a feed of new images for the price of the new rows only. **Integrations.** Send the results to Make, n8n, Zapier, Google Sheets, Slack, Google Drive, Airtable or any webhooks from the Integrations tab of the Actor, with no code. Apify also offers native actions for Make, n8n and Zapier. **API, SDKs and AI agents.** Every run is available through the Apify API and the official JavaScript and Python clients; the Actor can also be called by AI agents through the Apify MCP server. The example input in the API tab is a working call. **How "new" is decided here.** The actor remembers each image address together with the SHA-1 of the file it delivered. On the next run with the same `stateName`, an image is saved and charged again only if its content changed at that address (a new product photo under the same file name counts, a re-uploaded identical file does not). The actor still has to download an image to compare it, so the requests are made; only the saving and the charge are skipped. ### Use cases - **Product photo archives:** keep the images of your own shop pages, supplier pages or catalogue pages with their sizes, before a redesign or a platform move. - **Image audits:** list every picture of a set of pages with its real dimensions and file size, to find oversized files, wrong formats and images that are too small for a layout. - **Datasets and mood boards:** collect the pictures of pages you are allowed to use for research, design reference or machine-learning data preparation. - **Duplicate and change detection:** the SHA-1 column shows identical pictures under different addresses, and a schedule with **Only new rows** tells you when a picture changed. - **Migration checks:** download the images of the old pages, then compare sizes and hashes after the move. - **Feeding other tools:** pass the key-value store links to an image-processing, OCR or tagging step in Make, n8n, Zapier or your own code. Ready-made examples, each with the input filled in (open one and press Start, or save it as your own task): - [Product photos of online shop pages, with sizes](https://apify.com/rowcraft/bulk-image-downloader/examples/product-photos-of-demo-shops) - [All images of a web page saved with dimensions](https://apify.com/rowcraft/bulk-image-downloader/examples/images-of-a-portal-page) - [Large JPEG photos from a gallery page](https://apify.com/rowcraft/bulk-image-downloader/examples/large-photos-from-a-gallery-page) ### What this actor does not do - Log in: pages and images behind a login, a paywall or a cookie wall are not read. - Read social networks: Instagram, Pinterest, Facebook and similar sites are outside this actor. - Resize, convert, compress or watermark images: files are saved exactly as the server sent them. - Read text in pictures (OCR) or recognise what a picture shows. - Run JavaScript or a browser: pictures that a script adds after the page loads are not found. - Read or deliver photo metadata: camera, location and author fields inside a file are not read and not in the rows; the files themselves are saved unchanged, so they still contain whatever metadata the server sent. - Work around protection: a server that answers with an anti-bot page, 401, 403 or 429 is reported in COVERAGE and not charged; the actor does not use proxies, solve CAPTCHAs or send a fake referrer. - Give you the rights to use the pictures: see the FAQ. ### Limits and fair use - **One request per second per host** by default (minimum 250 ms). A page and the server that holds its images are different hosts, so they are paced separately. A longer Crawl-delay in a site's robots.txt is applied instead, up to 10 seconds. In our test runs this came to about one saved image per second on a typical page. - **Page size:** the first 5 MB of a page's HTML are read. - **File size:** 15 MB per image by default, up to 30 MB with `maxImageSizeMb`. A server that announces a larger file is not even asked for it. - **Images per page:** 100 saved by default (`maxImagesPerPage`, up to 2,000); at most five times as many addresses per page are tried, so a page with thousands of tiny pictures cannot use up a run. - **Pages per run:** up to 10,000 pages and 50,000 direct image links. - **Memory:** 256 MB is enough for the default limits; the run stops 90 seconds before its timeout and keeps everything saved until then. - **Refused images:** some image servers refuse a request that does not come from a page (hotlink protection). These images are listed as `blocked`; the actor does not pretend to be a browser on the page to get around that. After 10 refusals in a row on one page the rest of the page is skipped. - **How long files are kept:** the images live in the default key-value store of the run, which Apify deletes when the retention period of your plan ends (on the Free plan, the 10 most recent runs are kept for 4 months; check the retention setting of your own plan). Download what you need, or copy it to a named store or your own storage; named storages are kept until you delete them. - **robots.txt is obeyed** for every address the actor touches, including redirect targets and the image servers. If robots.txt disallows a path, that page or image is `robots_disallowed`; if robots.txt answers with a server error, the host is not read, as the robots.txt standard (RFC 9309) requires. - **Private addresses** (localhost, internal networks) are refused on the platform. ### Data source and licence The data is what a web page sends to every visitor: its HTML, and the image files it points to. The actor reads the page once, after checking robots.txt, and downloads the image files that the page itself shows. The rows contain facts about the files (size, format, hash) and the addresses; the files are saved unchanged in your storage. **The rights to the pictures stay with the page and its owner.** Most pictures on the web are protected by copyright or by a licence. The actor only downloads what a visitor's browser would download; it does not grant, check or transfer any right to use the files. You decide what you may do with them. Bulk Image Downloader is independent and not affiliated with or endorsed by the websites it reads or by the owners of the pictures it saves. ### Privacy: no personal data Rowcraft actors are built not to collect personal data: - No e-mail addresses, phone numbers or names of people are read from pages or delivered. Links starting with `mailto:`, `tel:` or `sms:` are ignored completely. - Photo metadata (EXIF: camera, GPS, author) is not read and not in the rows. - Image addresses with a user name or password inside are used without them, and an e-mail address inside an address is removed. - The alt text is cleaned of e-mail addresses, phone numbers and contact names next to a cue (Mr, Ms, "contact", "recruiter"); other names written in free text cannot be removed reliably. If the pages you read show photos of people with their names in the alt text, turn **Deliver the alt text** off. - The actor sends no cookies, fills no forms and never logs in. The files are the pictures of the pages you choose: a photo that shows a person is personal data under the law of many countries. You are responsible for using the files in line with the law that applies to you. ### Other Rowcraft actors All Rowcraft actors read official or public sources, deliver flat rows without personal data and support only-new runs and notifications: - [Ashby Jobs Scraper – Job Postings with Salary Ranges](https://apify.com/rowcraft/ashby-jobs-scraper) — Job postings from Ashby job boards (jobs.ashbyhq.com) by company: title, department, team, locations with country, employment and workplace type, published salary range, full text. - [Broken Link Checker – Find 404s and Dead Links API](https://apify.com/rowcraft/broken-link-checker) — Pay per crawled page, not per link: crawl a site within robots.txt and check every link on each page for 404s, 5xx errors, DNS and TLS failures and redirects. - [Career Site Jobs Scraper: Greenhouse, Lever, Ashby, Workday](https://apify.com/rowcraft/career-site-jobs-scraper) — Job listings from the career pages of the companies you choose on Greenhouse, Lever, Ashby, Workday, Workable, Personio, Recruitee, Teamtailor and Gem, in one run and one format: title, locations, department, salary when published, full text. - [Chrome Web Store Scraper: Users, Ratings & Versions](https://apify.com/rowcraft/chrome-web-store-scraper) — Reads public Chrome Web Store listing pages with no login, no proxy and no personal data: users, rating, category, version, update date, permissions and company developers. - [Domain Email and DNS Checker API: MX, SPF, DMARC, Providers](https://apify.com/rowcraft/domain-email-dns-checker) — Find which email provider, sending services and DNS host each domain uses, from public DNS records only. - [SIRENE France Company Scraper: SIREN, NAF, Revenue, Status](https://apify.com/rowcraft/france-company-register) — French companies from the official Recherche d'entreprises API (INSEE SIRENE + INPI): SIREN and SIRET, legal form, NAF activity, head-office address, employee band, revenue and net income, labels, creation date and VAT number. - [Gem Jobs Scraper – Job Board Listings from jobs.gem.com](https://apify.com/rowcraft/gem-jobs-scraper) — Job listings from Gem job boards (jobs.gem.com) by company: title, department, offices with country, employment type, remote, hybrid or on-site, requisition ID, publication date and full ad text, from the public Gem Job Board API. - [Google Play Apps Scraper: App Details, Installs, Ratings](https://apify.com/rowcraft/google-play-apps-scraper) — Public Google Play app details as flat rows: installs, rating, number of ratings, price, version, last update, minimum Android, ads and in-app purchases. - [Greenhouse Jobs Scraper – Job Listings by Company Board](https://apify.com/rowcraft/greenhouse-jobs-scraper) — Job listings from Greenhouse job boards by company: title, departments, offices, publication date, full ad text, published pay ranges. - [Himalayas Jobs Scraper: Remote Jobs API with Salaries](https://apify.com/rowcraft/himalayas-jobs-scraper) — Remote jobs from Himalayas through its public jobs API: title, company, salary range, seniority, categories, the countries and time zones open to candidates, full description and job link. - [KRS Poland Companies Scraper: Register Data, PKD, Status](https://apify.com/rowcraft/krs-poland-companies) — Polish companies from the official KRS register API of the Ministry of Justice: name, KRS, NIP and REGON numbers, legal form, status, address, PKD activity codes, share capital, branches and registration dates. - [LEI Records Scraper: Legal Entity Identifier Lookup API](https://apify.com/rowcraft/lei-records-scraper) — Legal Entity Identifier (LEI) records from the Global LEI Index, read through the public GLEIF API: legal name, legal form, register number, addresses, status, renewal date and parent companies. - [Lever Jobs Scraper – Job Postings from jobs.lever.co](https://apify.com/rowcraft/lever-jobs-scraper) — Job postings from Lever career pages (jobs.lever.co) by company: title, team, department, location, commitment, workplace type, salary range when published, description, requirements and benefits. - [Norway Company Register Scraper: Brønnøysund Business Data](https://apify.com/rowcraft/norway-company-register-scraper) — Norwegian companies from the Central Coordinating Register for Legal Entities (Brønnøysund, NLOD open data): organisation number, legal form, industry, employees, share capital, addresses, website, VAT and bankruptcy status. - [PDF Text Extractor: Text, Pages and Metadata from PDF Links](https://apify.com/rowcraft/pdf-text-extractor) — Get the text of every PDF you link, page by page, with page count, language and word count. - [Personio Jobs Scraper: Job Listings, Salaries, Departments](https://apify.com/rowcraft/personio-jobs-scraper) — Job ads from any company's Personio careers feed: title, department, office, employment type, schedule, seniority, salary when published, keywords and the full description in the language you choose. - [Platsbanken Scraper: Sweden Jobs, Employers, Org Numbers](https://apify.com/rowcraft/platsbanken-jobs-scraper) — Every job ad on Platsbanken (Arbetsförmedlingen) from the official JobTech API: headline, employer and organisation number, occupation codes, municipality, coordinates, salary type, deadline and full text. - [Recruitee Jobs Scraper – Job Listings by Company Career Site](https://apify.com/rowcraft/recruitee-jobs-scraper) — Job listings from Recruitee career sites by company: title, department, locations with country, employment type, remote flag, published salary and full text, one request per company. - [Robots.txt and AI Crawler Access Checker API](https://apify.com/rowcraft/robots-ai-crawler-checker) — Check which AI and search crawlers a website lets in: GPTBot, ClaudeBot, PerplexityBot, Google-Extended and more, read from robots.txt by the RFC 9309 rules. - [RSS Feed Finder and Reader – Blog and News Article API](https://apify.com/rowcraft/rss-feed-finder-reader) — Find the RSS, Atom and JSON feeds of any website and read their newest articles, from a domain name alone. - [SEO Audit Tool: Titles, Meta Tags, Headings and Links API](https://apify.com/rowcraft/seo-audit-tool) — Audit the on-page SEO of any list of pages or websites: titles, meta descriptions, headings, canonicals, indexing, links, images and structured data, with a score and the issues found per page. - [Shopify Products Scraper: Store Catalog Export to JSON, CSV](https://apify.com/rowcraft/shopify-products-scraper) — Products from any Shopify store's public catalog: title, vendor, type, tags, description, variants with price, compare-at price, SKU and stock, images, options, store currency. - [Sitemap URL Extractor: Every Page with Last-Modified Dates](https://apify.com/rowcraft/sitemap-url-extractor) — Get every page a site lists in its sitemaps, with last-modified dates, from robots.txt through sitemap indexes and .gz files. - [SSL Certificate and Security Headers Checker API](https://apify.com/rowcraft/ssl-security-headers-checker) — Check the TLS certificate and the HTTP security headers of every domain in one run, with an A+ to F grade and the exact issues to fix. - [Store Products Scraper – Shopify, WooCommerce, VTEX](https://apify.com/rowcraft/store-products-scraper) — Export the product catalogue of any Shopify, WooCommerce or VTEX store from its public catalogue endpoint: title, brand, prices, discounts, stock, categories, images and links, one row per product, the same columns on every platform. - [Structured Data Extractor: JSON-LD, Schema.org, Open Graph](https://apify.com/rowcraft/structured-data-extractor) — Pull the schema.org JSON-LD, Microdata, RDFa and Open Graph of any page list into flat rows: types, product price, availability, ratings, organization, breadcrumbs, with validation issues. - [Teamtailor Jobs Scraper – Career Site Jobs by Company](https://apify.com/rowcraft/teamtailor-jobs-scraper) — Job listings from Teamtailor career sites by company: title, department, role, locations with city and country, remote or hybrid status, publication date and full ad text, from the official job feed. - [TED Tenders Scraper: EU Public Procurement Notices API](https://apify.com/rowcraft/ted-tenders-scraper) — EU public procurement notices from TED (Tenders Electronic Daily), the official EU tenders portal, through its public Search API: title, buyer, country, CPV codes, values, deadlines, lots and document links. - [UK Companies House Scraper: Company Search & Profiles API](https://apify.com/rowcraft/uk-companies-house-scraper) — UK companies from the official Companies House API with your free key: search by name, status, type, SIC code, date or location, or look up company numbers. - [UK Tenders Scraper: Find a Tender + Contracts Finder API](https://apify.com/rowcraft/uk-tenders-scraper) — UK public procurement notices from Find a Tender and Contracts Finder, the official UK government portals, through their open OCDS APIs: title, buyer, region, CPV codes, values, deadlines, notice type and links. - [Bulk URL Status and Redirect Chain Checker API](https://apify.com/rowcraft/url-status-redirect-checker) — Check the status code, redirect chain, canonical and indexing signals of every URL in a list, with the final destination and a loop flag. - [VTEX Products Scraper – Public Catalog Export](https://apify.com/rowcraft/vtex-products-scraper) — Export the catalogue of any VTEX store (Auchan, Chedraui and thousands of retailers in Europe and Latin America) from its public search endpoint: title, brand, EAN, prices, list prices, stock, categories, specifications and images, one row per product. - [Website to Markdown Extractor: Clean Text for LLMs and RAG](https://apify.com/rowcraft/website-markdown-extractor) — Turn a list of web page addresses into clean Markdown and plain text for LLMs and RAG: the main content only, with headings, links, images and tables. - [Website Screenshot API: Full-Page PNG, JPEG and PDF Captures](https://apify.com/rowcraft/website-screenshot-api) — Capture full-page or viewport screenshots of any public web page as PNG, JPEG or WebP, with an optional A4 PDF. - [Website Tech Stack Detector – Technology Lookup API](https://apify.com/rowcraft/website-tech-stack-detector) — Find the technologies behind a list of websites: CMS, e-commerce platform, analytics, tag managers, ad pixels, consent tools, chat, CDN and payments, from one polite home-page request per domain. - [WooCommerce Products Scraper – Store API Export](https://apify.com/rowcraft/woocommerce-products-scraper) — Export every product of a WooCommerce store through its public Store API: title, SKU, prices and sale prices, stock, categories, tags, attributes, ratings, images and links, one row per product. - [Workable Jobs Scraper: Job Listings from Career Pages](https://apify.com/rowcraft/workable-jobs-scraper) — Job listings from any company's Workable career page: title, department, location, remote or on-site, employment type, description, requirements, benefits and salary when published. - [Workday Jobs Scraper – Jobs from myworkdayjobs.com Sites](https://apify.com/rowcraft/workday-jobs-scraper) — Job listings from Workday career sites (myworkdayjobs.com) by company: title, locations, country, posting date, time type, requisition ID and the full description. ### FAQ **Are the images mine to use?** The actor only downloads what a visitor's browser would download. The rights to a picture stay with the page's owner or the photographer. Use your own images, images with a licence that allows your use, or pictures you have permission for. The actor does not check licences. **What does it cost for a page with many images?** You pay for each image saved: $2.00 per 1,000 on the Free plan and $1.50 per 1,000 on the Business plan. Images below the size filter, duplicates, failed downloads and refused images are not charged. **How long are the files kept?** In the default key-value store of the run, until your plan's retention period for unnamed storages ends (Free plan: the 10 most recent runs for 4 months). Download or copy the files you need; a named storage is kept until you delete it. **Why is the result empty?** Check `COVERAGE`. The usual reasons: every image was below the minimum size (lower `minWidth` and `minHeight`), the page loads its pictures with JavaScript, robots.txt disallows the page or the images (`robots_disallowed`), the site answered with an anti-bot page (`blocked`), or with **Only new rows** on nothing had changed. Nothing is charged for those, apart from the start event. **Why were small images skipped?** The default minimum is 100 x 100 px, to leave out tracking pixels, spacers and icons. Set both to 0 to save everything. Skipped images are listed as `too_small` in `COVERAGE` with their real size. **Is it legal?** The actor reads public pages, obeys robots.txt and collects pictures that a page shows to every visitor. Whether you may copy, store or reuse a given picture depends on its copyright or licence and on the law that applies to you. **Does it collect personal data?** No personal data is read from pages or put in the rows: no e-mails, phone numbers or names, and photo metadata is not read. Pictures themselves can show people; see the Privacy section. **Which formats and sizes does it read?** JPEG, PNG, GIF, WebP, AVIF, SVG, BMP, ICO and TIFF. The size comes from the file header; for an SVG it is the width and height or the viewBox. A JPEG that carries a quarter-turn rotation flag is reported as it is displayed. **Why does it not take every size of a picture?** Pages list one photo at several widths so that browsers pick the right one. Saving all of them would triple your bill for the same picture, so by default only the largest listed version is saved. Tick **Save every listed size of a picture** if you want them all. **Why does an image say "blocked"?** The server that holds the image answered with 401, 403 or 429 or an anti-bot page. The actor does not work around that. Try again later, with a longer `requestIntervalMs`, or use a different source. **Can I get the images of a whole website?** Not by itself: it reads the pages you list and does not follow links. Use a sitemap or link-list tool to build the list of pages first, then paste the addresses here. **Do I pay for images that were already delivered?** With **Only new rows** on, an image whose content did not change since your last run with the same state name is not saved and not charged. ### Support and reviews **Problems, missing fields, questions:** open an issue on the **Issues** tab of this Actor. We answer within one working day and fix confirmed bugs in the next release; the changelog lists every change. If this Actor saved you time, a short review on its page helps other users find it and helps us keep improving it. # Changelog This Actor's version history is a separate document: https://apify.com/rowcraft/bulk-image-downloader/changelog.md # Actor input Schema ## `urls` (type: `array`): Web pages to collect the images of, one address per line (https://example.com/product/1). The images shown on each page are found in its HTML: img tags, srcset, picture, and the og:image preview. Duplicates and invalid entries are skipped and never charged. ## `imageUrls` (type: `array`): Links that point straight at an image file (https://example.com/photo.jpg), one per line. They go through the same checks and filters as the images found on pages, and are listed with the source `direct`. ## `minWidth` (type: `integer`): Images narrower than this are not saved and not charged: tracking pixels, spacers and icons. 0 = no limit. ## `minHeight` (type: `integer`): Images lower than this are not saved and not charged. 0 = no limit. ## `formats` (type: `array`): Save only these image formats. Empty = every format. The format is read from the file itself; when a picture lists several versions in different formats, the versions that announce another format are not downloaded. ## `maxImagesPerPage` (type: `integer`): Stop reading a page after this many images were saved from it. The rest are listed as not read in COVERAGE. ## `maxItems` (type: `integer`): Stop after this many images are saved in the whole run. 0 = no limit. ## `allSizes` (type: `boolean`): Off (default): one file per picture, its largest listed version (the biggest srcset width), so a product photo is not saved three times at three sizes. On: every size and every format a picture lists is downloaded. ## `includeLinkedImages` (type: `boolean`): Add images that a page only links to (), such as the full-size versions behind gallery thumbnails. Only addresses that end in an image file extension are taken. ## `includeBackgroundImages` (type: `boolean`): Add images set with background-image in the style attribute of a tag. Backgrounds defined in separate stylesheets are not read. ## `dedupe` (type: `boolean`): On (default): an image address already handled, and a file with the same content (SHA-1) as one already saved in this run, is skipped and not charged. Off: every occurrence is saved. ## `maxImageSizeMb` (type: `number`): Files bigger than this are not saved and not charged; a file that announces its size is not even downloaded. Maximum 30. ## `includeAltText` (type: `boolean`): On (default): the alt attribute of the image is in the `alt` column, with e-mail addresses, phone numbers and contact names next to a cue removed. Off: the column stays empty. Turn it off if the pages show photos of people with their names in the alt text. ## `onlyNew` (type: `boolean`): Remember the rows already delivered to you (in a key-value store in your Apify account) and deliver only rows that appeared since the last run with the same state key. The first run delivers everything that matches; later runs cost only the new rows. Ideal for schedules. ## `stateName` (type: `string`): Name of the memory used by "Only new rows". Use a different name for each schedule or search (for example `stockholm-python`) so they do not share one memory. ## `notifyUrl` (type: `string`): A webhook address that receives one JSON POST with the number of new rows and links to the dataset: a Slack or Discord incoming webhook, a Make, n8n or Zapier catch hook, or your own endpoint. The message is also in the `text` (Slack) and `content` (Discord) fields. ## `notifyWhenEmpty` (type: `boolean`): By default the notification is sent only when at least one row was delivered. ## `requestIntervalMs` (type: `integer`): Pause between two requests to the same host (a page and its image server are separate hosts). Default 1000 ms; minimum 250. A longer Crawl-delay in a site's robots.txt is applied instead, up to 10 s. ## Actor input object example ```json { "urls": [ "https://www.wikipedia.org", "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "https://commons.wikimedia.org/wiki/Main_Page" ], "minWidth": 100, "minHeight": 100, "maxImagesPerPage": 100, "maxItems": 500, "allSizes": false, "includeLinkedImages": false, "includeBackgroundImages": false, "dedupe": true, "maxImageSizeMb": 15, "includeAltText": true, "onlyNew": false, "stateName": "default", "notifyWhenEmpty": false, "requestIntervalMs": 1000 } ``` # Actor output Schema ## `results` (type: `string`): One row per image saved, in the default dataset (JSON, CSV, Excel and other formats via the dataset API). ## `runSummary` (type: `string`): Counts, filters used, warnings and why the run stopped (RUN_SUMMARY record in the default key-value store). ## `files` (type: `string`): The image files themselves, in the default key-value store of the run: the fileKey of each row is the record key. ## `coverage` (type: `string`): One line per page, and one per image that was not saved, with the reason: too_small, format_filtered, duplicate, unchanged, too_large, not_image, not_found, blocked, robots_disallowed, error or not_checked (COVERAGE record). # 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 = { "urls": [ "https://www.wikipedia.org", "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "https://commons.wikimedia.org/wiki/Main_Page" ] }; // Run the Actor and wait for it to finish const run = await client.actor("rowcraft/bulk-image-downloader").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 = { "urls": [ "https://www.wikipedia.org", "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "https://commons.wikimedia.org/wiki/Main_Page", ] } # Run the Actor and wait for it to finish run = client.actor("rowcraft/bulk-image-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.wikipedia.org", "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html", "https://commons.wikimedia.org/wiki/Main_Page" ] }' | apify call rowcraft/bulk-image-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,rowcraft/bulk-image-downloader" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/YPRXQpGdN0uXLzgoE/builds/SP5boGcqXBugZ5cSD/openapi.json