Base URL
Authentication
Include your API key in theapi-key header for every request. See Authentication for details.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /users/{id} | Get user data. Use @me for your profile. |
| POST | /upload | Upload an image or video. |
| GET | /uploads | List your recent uploads. |
| DELETE | /deleteUpload | Delete an upload by filename. |
| GET | /discover | Get public uploads for the discover feed. |
Rate limits
- 15 requests per minute per user for most endpoints.
- 8 uploads per second before temporary suspension. Exceeding this may ratelimit your account.
- See Rate limits for details.
Error format
Errors return JSON with anerror field:
HTTP status codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request (invalid input, unsupported file type, file too large) |
| 401 | Unauthorised (missing or invalid API key) |
| 403 | Forbidden (suspended account or insufficient permissions) |
| 404 | Not found |
| 413 | Payload too large (file exceeds 5GB) |
| 429 | Rate limit exceeded |
| 500 | Server error |