{ "openapi": "3.0.1", "info": { "title": "Bulk Image Downloader & Converter — Resize, WebP, ZIP", "description": "Download images in bulk from image URLs or whole web pages. Optionally resize, compress and convert to JPG, PNG or WebP (HEIC and AVIF input supported), dedupe, filter small icons and get one ZIP. Public link, size and dimensions per image. Failed images are free.", "version": "1.0", "x-build-id": "tGtPtOS38BLvXfbhF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidydata~bulk-image-downloader-converter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidydata-bulk-image-downloader-converter", "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/tidydata~bulk-image-downloader-converter/runs": { "post": { "operationId": "runs-sync-tidydata-bulk-image-downloader-converter", "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/tidydata~bulk-image-downloader-converter/run-sync": { "post": { "operationId": "run-sync-tidydata-bulk-image-downloader-converter", "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": "Image or page URLs", "type": "array", "description": "Direct image URLs and/or web page URLs. Pages are scanned for images (img, srcset, lazy-loaded images, og:image and links to image files). Detected automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "outputFormat": { "title": "Output format", "enum": [ "original", "jpeg", "png", "webp" ], "type": "string", "description": "Keep the original file untouched, or convert every image to the same format.", "default": "original" }, "maxWidth": { "title": "Max width (px)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Shrink images wider than this, keeping the aspect ratio. Images are never upscaled. Leave empty to keep the size." }, "maxHeight": { "title": "Max height (px)", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Shrink images taller than this, keeping the aspect ratio. Leave empty to keep the size." }, "quality": { "title": "Quality (JPG/WebP)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Compression quality 1-100. 80-85 is visually lossless for most photos and much smaller.", "default": 85 }, "stripMetadata": { "title": "Remove metadata (EXIF, GPS)", "type": "boolean", "description": "When an image is converted or resized, drop EXIF/GPS data (orientation is applied first, so photos stay upright).", "default": true }, "minWidth": { "title": "Min width (px)", "minimum": 0, "type": "integer", "description": "Skip images narrower than this (useful to ignore icons, logos and tracking pixels when scanning pages). Skipped images are free.", "default": 0 }, "minHeight": { "title": "Min height (px)", "minimum": 0, "type": "integer", "description": "Skip images shorter than this. Skipped images are free.", "default": 0 }, "createZip": { "title": "Also create one ZIP file", "type": "boolean", "description": "Bundle all saved images into images.zip in the key-value store (link in the run log and output).", "default": false }, "dedupe": { "title": "Skip duplicates", "type": "boolean", "description": "Skip images whose content is identical to one already saved (SHA-256). Duplicates are free.", "default": true }, "maxImagesPerPage": { "title": "Max images per page", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Only the first N images found on each web page are downloaded.", "default": 200 }, "maxImages": { "title": "Max images in total", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after saving this many images (protects your budget).", "default": 1000 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Images bigger than this are skipped.", "default": 30 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }