imgur

---
name: imgur
description: Imgur API for image hosting. Use when user mentions "Imgur", "upload
  image", "image hosting", or asks about image sharing.
---

## How to Use

### Upload Local Image

```bash
curl -X POST https://api.imgur.com/3/image -H "Authorization: Client-ID $IMGUR_CLIENT_ID" -F "image=@/path/to/image.png"
```

### Upload from URL

```bash
curl -X POST https://api.imgur.com/3/image -H "Authorization: Client-ID $IMGUR_CLIENT_ID" -F "image=https://example.com/image.png" -F "type=url"
```

### Upload Base64

```bash
curl -X POST https://api.imgur.com/3/image -H "Authorization: Client-ID $IMGUR_CLIENT_ID" -F "image=$(base64 -i /path/to/image.png)" -F "type=base64"
```

### Optional Parameters

| Parameter | Description |
|-----------|-------------|
| title | Image title |
| description | Image description |
| name | Filename |

```bash
curl -X POST https://api.imgur.com/3/image -H "Authorization: Client-ID $IMGUR_CLIENT_ID" -F "image=@screenshot.png" -F "title=My Screenshot" -F "description=Screenshot from my app"
```

## Response

```json
{
  "data": {
  "id": "abc123",
  "link": "https://i.imgur.com/abc123.png",
  "deletehash": "xyz789"
  },
  "success": true,
  "status": 200
}
```

Key fields:
- `data.link` - Public URL to use in Markdown: `![img](https://i.imgur.com/abc123.png)`
- `data.deletehash` - Save this to delete the image later

## Delete Image

Replace `<your-deletehash>` with the deletehash from the upload response:

```bash
curl -X DELETE https://api.imgur.com/3/image/<your-deletehash> -H "Authorization: Client-ID $IMGUR_CLIENT_ID"
```

## Rate Limits

- ~12,500 requests/day
- ~1,250 uploads/day (uploads cost 10 credits)
- Headers show remaining: `X-RateLimit-ClientRemaining`

## Guidelines

1. **Save deletehash**: Store it if you need to delete images later
2. **Anonymous uploads**: Images are not tied to any account
3. **Supported formats**: JPEG, PNG, GIF, APNG, TIFF, BMP, PDF, XCF, WebP
4. **Max file size**: 20MB for images, 200MB for GIFs

## API Reference

- Documentation: https://apidocs.imgur.com/
- Register App: https://api.imgur.com/oauth2/addclient