A powerful, developer-friendly REST API for downloading images from any website. Built for speed, reliability, and ease of use.
Use this API to programmatically collect images for testing, content workflows, and archiving. Submit a single URL or a small batch of URLs and receive a ready-to-download ZIP file. No authentication is required, and responses are compact, consistent JSON.
Get started with the Image Downloader API in less than 5 minutes
There are no API keys or SDKs to install. Send a JSON POST request and handle the returned download URL. Provide either a single url or an array of urls, and optionally set maxImages to control volume.
Send a POST request to our API endpoint with the URL you want to scrape
Receive a download URL for a ZIP file containing all images
Use the provided URL to download your organized image collection
All endpoints are prefixed with /api/v1. Combine this with the paths below to form the full request URL.
Send a JSON body with either url (string) or urls (string[] up to 10), plus optional maxImages to cap images per URL.
Choose your preferred programming language and example type
Toggle between single and bulk modes to see request shapes. Pick a language to copy a ready-to-run snippet. Use the copy button on each block and switch themes as needed.
1curl -X POST https://www.imgminer.com/api/v1/download \
2 -H "Content-Type: application/json" \
3 -d '{
4 "url": "https://example.com",
5 "maxImages": 50
6 }'Understand the API response format with real examples
All responses are JSON. Successful calls include a data object with fields likedownloadUrl and totalImages. Errors return an errormessage and may include details in data.errors.
1{
2 "success": true,
3 "data": {
4 "downloadUrl": "/api/v1/download/file/ZXhhbXBsZS1jb20taW1hZ2VzLTIwMjQtMDEtMTUuemlw",
5 "filename": "example-com-images-2024-01-15.zip",
6 "totalImages": 25,
7 "fileSize": "2.4MB"
8 }
9}downloadUrl to fetch the ZIP file. The totalImages count helps with progress reporting. In bulk mode, results lists per-URL totals.1{
2 "success": false,
3 "error": "No images found on the website",
4 "data": {
5 "errors": [
6 "Failed to load images from https://example.com",
7 "Website returned 404 status"
8 ]
9 }
10}data.errors includes actionable details you can surface to users.Complete documentation for all available endpoints and parameters
Choose between single-URL and bulk modes. In bulk mode, provide up to 10 URLs. UsemaxImages to keep downloads fast and predictable.
urlrequiredWebsite URL to scrape images from
Type: string
urlsrequired*Array of URLs for bulk downloads
Type: string[] (max: 10)
maxImagesoptionalMaximum images per URL
Type: number (default: 50, max: 100)
url for single URL or urls for bulk downloadssuccessRequest success status
Type: boolean
data.downloadUrlZIP file download URL
Type: string
data.totalImagesTotal images found
Type: number
data.resultsPer-URL results (bulk only)
Type: array
200Success400Bad Request404No Images Found405Method Not Allowed429Rate Limited500Server ErrorEverything you need to know about API capabilities and constraints
Integrate our powerful image downloader API into your applications today
Need help? Check our documentation or test the API using our web interface.