{ "openapi": "3.0.1", "info": { "title": "Picpail — Bulk Image Downloader: All Images from URLs to ZIP", "description": "Download all images from web pages or image URLs into one ZIP, full-size originals instead of thumbnails: img, srcset, lazy-load, CSS, og:image. Real format and pixel size, duplicate removal, size/format filters, monitor mode. $0.0005 per image; duplicates and skips free.", "version": "0.1", "x-build-id": "sa9cxK1NgAMMp8KXI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cybermax~bulk-image-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cybermax-bulk-image-downloader", "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/cybermax~bulk-image-downloader/runs": { "post": { "operationId": "runs-sync-cybermax-bulk-image-downloader", "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/cybermax~bulk-image-downloader/run-sync": { "post": { "operationId": "run-sync-cybermax-bulk-image-downloader", "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": [ "urls" ], "properties": { "urls": { "title": "Page or image URLs", "type": "array", "description": "Web pages to take every image from (product pages, galleries, blog posts, listings) and/or direct image URLs (…/photo.jpg). Mix freely; bare domains get https://. Each image is downloaded, checked to be a real image and measured.", "items": { "type": "string" } }, "output": { "title": "Deliver images as", "enum": [ "zip", "zipPerPage", "files", "list" ], "type": "string", "description": "How to get the images. ZIPs are split into parts at 'ZIP part size'. Every mode also returns one dataset row per image (URL, format, width, height, bytes, SHA-256, alt text, where it was found).", "default": "zip" }, "minWidth": { "title": "Minimum width (px)", "minimum": 0, "type": "integer", "description": "Skip images narrower than this (measured from the file, not the HTML). 100 skips icons and thumbnails. Skipped images are free.", "default": 0 }, "minHeight": { "title": "Minimum height (px)", "minimum": 0, "type": "integer", "description": "Skip images shorter than this.", "default": 0 }, "formats": { "title": "Only these formats", "type": "array", "description": "Keep only these real formats (detected from the file bytes). Empty = all formats.", "items": { "type": "string", "enum": [ "jpeg", "png", "webp", "gif", "avif", "svg", "ico", "bmp", "tiff", "heic" ], "enumTitles": [ "JPEG", "PNG", "WebP", "GIF", "AVIF", "SVG", "ICO", "BMP", "TIFF", "HEIC" ] } }, "minFileSizeKb": { "title": "Minimum file size (KB)", "minimum": 0, "type": "integer", "description": "Skip files smaller than this.", "default": 0 }, "maxFileSizeMb": { "title": "Maximum file size (MB)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Larger files are skipped (not downloaded).", "default": 25 }, "urlPattern": { "title": "Image URL must match (regex)", "type": "string", "description": "Optional regular expression, case-insensitive, e.g. /products/|cdn\\.shopify\\.com" }, "excludeUrlPattern": { "title": "Skip image URLs matching (regex)", "type": "string", "description": "Optional, e.g. logo|icon|sprite|avatar" }, "sameDomainOnly": { "title": "Only images from the page's own site", "type": "boolean", "description": "Skip images hosted on other domains (ads, trackers, embeds). The site's own CDN subdomains (cdn.example.com) count as the same site.", "default": false }, "dedupe": { "title": "Remove duplicates", "type": "boolean", "description": "Download each image URL once and drop byte-identical files (SHA-256) across all pages. Duplicates are free.", "default": true }, "skipTrackingPixels": { "title": "Skip tracking pixels", "type": "boolean", "description": "Skip 1×1 and 2×2 images.", "default": true }, "upgradeToOriginals": { "title": "Full-size originals instead of thumbnails", "type": "boolean", "description": "Pages usually show resized copies. For Shopify, WordPress (media library + Jetpack), Wikimedia, Cloudinary, Wix, Squarespace, Contentful and imgix URLs, download the full-size original instead (falls back to the page's copy if the original can't be fetched). The row keeps both URLs.", "default": true }, "srcset": { "title": "Responsive images (srcset)", "enum": [ "largest", "all", "none" ], "type": "string", "description": "Pages often offer several sizes of the same picture. 'Largest' gets the best quality once.", "default": "largest" }, "includeLinkedImages": { "title": "Linked originals ()", "type": "boolean", "description": "Gallery thumbnails often link to the full-size original. Links that turn out to be HTML pages are skipped for free.", "default": true }, "includeCssBackgrounds": { "title": "CSS background images", "type": "boolean", "description": "Inline style and