Base URL
All API requests are made to:Authentication
Include your API key in theapi-key header with every request. See Authentication for details on finding your key and security best practices.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /users/{id} | Fetch a user profile. Use @me for your own account. |
POST | /upload | Upload an image or video file. |
GET | /uploads | List your 30 most recent uploads. |
DELETE | /deleteUpload | Delete an upload by filename. |
GET | /discover | Browse public uploads from the community. |
GET | /blocks | List your blocked users. |
POST | /block | Block a user. |
POST | /unblock | Unblock a user. |
POST | /reports | Report a post. |
Rate limits
- 15 requests per minute per user across most endpoints.
- 8 uploads per second before temporary throttling.
429 responses.
Error format
All errors return a JSON object with anerror field:
HTTP status codes
| Code | Meaning |
|---|---|
200 | Success |
400 | Bad request — invalid input, unsupported file type, or file too large |
401 | Unauthorised — missing or invalid API key |
403 | Forbidden — account suspended or insufficient permissions |
404 | Not found |
413 | Payload too large — file exceeds your plan’s size limit |
429 | Rate limit exceeded |
500 | Internal server error |