# Cloudinary API

**Provider:** Cloudinary
**Category:** storage
**Base URL:** `https://api.cloudinary.com/v1_1/{cloud_name}`
**Auth:** basic — `Authorization: Basic base64(api_key:api_secret)`
**Rate Limit:** 500 requests/hour (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Pay per use (pay-as-you-go)
**Docs:** https://cloudinary.com/documentation/image_upload_api_reference

## Description

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.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.cloudinary.com/v1_1/{cloud_name}/{resource_type}/upload` | Upload a file |
| GET | `https://api.cloudinary.com/v1_1/{cloud_name}/{resource_type}/list/{next_cursor}` | List resources in a folder |
| GET | `https://api.cloudinary.com/v1_1/{cloud_name}/resources/{resource_type}/{public_id}` | Get metadata for a resource |
| POST | `https://api.cloudinary.com/v1_1/{cloud_name}/{resource_type}/destroy` | Delete a resource |
| POST | `https://api.cloudinary.com/v1_1/{cloud_name}/resources/{resource_type}/tags` | Add or remove tags |

## Authentication

Use API Key and API Secret as Basic Auth credentials. Signed uploads use HMAC-SHA1.

```
Authorization: Basic base64(api_key:api_secret)
```

## Sample Request

```bash
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"
```

## Sample Response

```json
{
  "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"
}
```

## Pricing Details

Free: 25 credits/mo. Plus: $89/mo for 225 credits. Advanced: $224/mo. 1 credit ≈ 1GB storage or bandwidth or 1,000 transformations.

---

*Source: [API Map](https://apimap.dev/apis/cloudinary/) — CC BY 4.0*