API Overview
The img-src API allows you to upload, transform, and manage images programmatically. All API endpoints are available at https://api.img-src.io.
Base URL
Authentication
All API endpoints (except /health) require authentication using an API key.
Getting an API Key
- Sign in to your dashboard
- Go to Settings
- Click Create API Key
- Copy the key immediately (it won’t be shown again)
Using Your API Key
Include your API key in the Authorization header:
curl https://api.img-src.io/api/v1/images \
-H "Authorization: Bearer imgsrc_YOUR_API_KEY"
API keys start with imgsrc_ prefix. Keep them secure and never expose them in client-side code.
Rate Limiting
Rate limits are applied per API key:
| Plan | Requests/Minute |
|---|
| Free | 100 |
| Pro | 500 |
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1704067260
429 Too Many Requests response.
All responses are JSON. Successful responses return the requested data:
{
"id": "img_abc123",
"url": "https://img-src.io/i/username/photo.jpg",
...
}
{
"error": {
"code": "NOT_FOUND",
"message": "Image not found",
"status": 404
}
}
Common Error Codes
| Code | Status | Description |
|---|
UNAUTHORIZED | 401 | Missing or invalid API key |
FORBIDDEN | 403 | Insufficient permissions |
NOT_FOUND | 404 | Resource not found |
VALIDATION_ERROR | 400 | Invalid request parameters |
RATE_LIMITED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Server error |
limit and offset parameters:
curl "https://api.img-src.io/api/v1/images?limit=20&offset=40" \
-H "Authorization: Bearer imgsrc_YOUR_API_KEY"
{
"images": [...],
"total": 150,
"limit": 20,
"offset": 40
}
CDN URLs
After uploading, images are served via CDN:
- Primary:
https://img-src.io/i/{username}/{path}
- Secondary:
https://cdn.img-src.io/{username}/{path}
Both URLs support the same transformation parameters.
API Endpoints
