imgur

• Upload images to get shareable URLs
• Host images for blog posts or documentation
• Get image URLs for use in Markdown content
• Anonymous image uploads (no account needed)

Set the following environment variable:

```bash

export IMGUR_CLIENT_ID=your_client_id

```

Get your Client ID from: https://api.imgur.com/oauth2/addclient

When registering:

• Authorization type: "OAuth 2 authorization without a callback URL"
• You only need the Client ID for anonymous uploads

> Important: When using $VAR in a command that pipes to another command, wrap the command containing $VAR in bash -c '...'. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.

> ```bash

> bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"'

> ```

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"

```

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

Replace with the deletehash from the upload response:

```bash

curl -X DELETE https://api.imgur.com/3/image/ -H "Authorization: Client-ID ${IMGUR_CLIENT_ID}"

```

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

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

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