Cloudinary is a media management platform that handles the entire media pipeline. Upload images and videos, apply on-the-fly transformations via URL parameters (resize, crop, watermark, format convert, quality optimize), organize with tags and folders, and deliver via global CDN.
https://api.cloudinary.com/v1_1/{cloud_name}
Auth type
Basic Auth
Auth header
Authorization: Basic base64(api_key:api_secret)
Rate limit
500 requests/hour (free)
Pricing
Pay per use
Free quota
25 credits/month (≈25GB storage, 25GB bandwidth)
Documentation
https://cloudinary.com/documentation/image_upload_api_reference
Endpoint status
Server online — HTTP 404 — server is online but path returned an error (may require auth)973ms
(checked Mar 29, 2026)
Builder score
B
65%
builder-friendly
Use API Key and API Secret as Basic Auth credentials. Signed uploads use HMAC-SHA1.
Authorization: Basic base64(api_key:api_secret)
Free: 25 credits/mo. Plus: $89/mo for 225 credits. Advanced: $224/mo. 1 credit ≈ 1GB storage or bandwidth or 1,000 transformations.
| Method | Path | Description |
|---|---|---|
| POST | /{resource_type}/upload |
Upload a file |
| GET | /{resource_type}/list/{next_cursor} |
List resources in a folder |
| GET | /resources/{resource_type}/{public_id} |
Get metadata for a resource |
| POST | /{resource_type}/destroy |
Delete a resource |
| POST | /resources/{resource_type}/tags |
Add or remove tags |
curl https://api.cloudinary.com/v1_1/$CLOUD_NAME/image/upload \ -u "$CLOUDINARY_API_KEY:$CLOUDINARY_API_SECRET" \ -F "file=@/path/to/image.jpg" \ -F "folder=products" \ -F "public_id=product-001"
{
"asset_id": "b5e6d2b39ba3e0869d67141ba7dba6cf",
"public_id": "products/product-001",
"format": "jpg",
"width": 1920,
"height": 1080,
"bytes": 482604,
"secure_url": "https://res.cloudinary.com/demo/image/upload/products/product-001.jpg",
"created_at": "2024-01-18T12:00:00Z"
}
Data sourced from API Map. Always verify pricing and rate limits against the official Cloudinary documentation.