Image Downloader API

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.

Lightning Fast

No Auth Required

Developer Friendly

Quick Start Guide Try Web Interface

Quick Start

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.

Make a Request

Send a POST request to our API endpoint with the URL you want to scrape

Get Download Link

Receive a download URL for a ZIP file containing all images

Download Images

Use the provided URL to download your organized image collection

Base URL

https://www.imgminer.com/api/v1

All endpoints are prefixed with /api/v1. Combine this with the paths below to form the full request URL.

Main Endpoint

POST /download

Send a JSON body with either url (string) or urls (string[] up to 10), plus optional maxImages to cap images per URL.

Interactive Examples

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.

single-url-download.sh

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  }'

Response Examples

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.

Success Response

200 OK

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}

Use the downloadUrl to fetch the ZIP file. The totalImages count helps with progress reporting. In bulk mode, results lists per-URL totals.

Error Response

400 Bad Request

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}

Validate inputs to prevent common errors (e.g., malformed URLs, missing fields). When present,data.errors includes actionable details you can surface to users.

API Reference

Complete documentation for all available endpoints and parameters

Request Parameters

Choose between single-URL and bulk modes. In bulk mode, provide up to 10 URLs. UsemaxImages to keep downloads fast and predictable.

urlrequired

Website URL to scrape images from

Type: string

urlsrequired*

Array of URLs for bulk downloads

Type: string[] (max: 10)

maxImagesoptional

Maximum images per URL

Type: number (default: 50, max: 100)

* Use either url for single URL or urls for bulk downloads

Response Fields

success

Request success status

Type: boolean

data.downloadUrl

ZIP file download URL

Type: string

data.totalImages

Total images found

Type: number

data.results

Per-URL results (bulk only)

Type: array

Status Codes

200Success

400Bad Request

404No Images Found

405Method Not Allowed

429Rate Limited

500Server Error

Features & Limitations

Everything you need to know about API capabilities and constraints

Features

Single & bulk URL downloads (up to 10 URLs)

Multiple image formats (JPG, PNG, GIF, WebP, SVG, BMP, ICO)

Configurable image limits (1-100 per URL)

ZIP file compression with organized structure

No authentication or registration required

RESTful API with JSON responses

Comprehensive error handling

Real-time processing

Limitations

Maximum 10 URLs per bulk request

Maximum 100 images per URL

Rate limit: 60 requests per minute

Large downloads may timeout (keep under 50MB)

Some websites may block automated requests

No authentication (public API)

Educational/development use recommended

Ready to Start Building?

Integrate our powerful image downloader API into your applications today

Try Web Interface View Documentation

Need help? Check our documentation or test the API using our web interface.