Image Downloader API

A powerful, developer-friendly REST API for downloading images from any website. Built for speed, reliability, and ease of use.

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

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

Main Endpoint

POST /download

Interactive Examples

Choose your preferred programming language and example type

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

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}

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}

API Reference

Complete documentation for all available endpoints and parameters

Request Parameters

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.