CLI & API Reference
All three services are available as a JSON API — use curl
or any HTTP client from Linux, BSD, macOS, or Windows.
Base URL
https://r3rr.com
Response format
All endpoints return application/json.
Success: {"ok":true, ...}.
Error: {"ok":false,"error":"..."}.
Rate limiting — each action shares a token bucket with the web interface:
shorten (20 req/min), paste (10 req/min), image upload (10 req/min).
Exceeding the limit returns HTTP
429.
Paste
POST
/api/paste
Create a new paste. Returns JSON with the URL and raw URL.
Fields
| Name | Required | Description |
|---|---|---|
| content | required | Paste text, max 512 KB |
| title | optional | Optional title |
| language | optional | Language key or "auto" (default: auto) |
| burn_after | optional | "1" to delete on first view |
| expiry | optional | Seconds: 0, 3600, 86400, 604800, 2592000 |
Examples
From a file
curl -F 'content=@file.py' -F 'language=python' https://r3rr.com/api/paste
From stdin
cat script.sh | curl -F 'content=@-' https://r3rr.com/api/paste
Burn after read
curl -F 'content=@secret.txt' -F 'burn_after=1' https://r3rr.com/api/paste
JSON body
curl -H 'Content-Type: application/json' -d '{"content":"echo hi","language":"bash"}' https://r3rr.com/api/paste
Response
{"ok":true,"code":"d2tV7Y","url":"/paste/d2tV7Y","raw_url":"/paste/d2tV7Y/raw","language":"bash","expires":null}
GET
/api/paste/{code}
Retrieve paste metadata and full content as JSON.
Examples
Get paste
curl https://r3rr.com/api/paste/d2tV7Y
Response
{"ok":true,"code":"d2tV7Y","title":null,"language":"bash","content":"...","burn_after":false,"view_count":4,"expires_at":null,"created_at":"..."}URL Shortener
POST
/api/shorten
Shorten a URL. Returns the short URL and metadata.
Fields
| Name | Required | Description |
|---|---|---|
| url | required | The long URL to shorten (include https://) |
| title | optional | Optional label |
| expiry | optional | Seconds: 0, 3600, 86400, 604800, 2592000 |
Examples
Form data
curl -F 'url=https://example.com/long/path' https://r3rr.com/api/shorten
JSON body
curl -H 'Content-Type: application/json' -d '{"url":"https://example.com","expiry":86400}' https://r3rr.com/api/shorten
Response
{"ok":true,"code":"1RsVBd","short_url":"https://r3rr.com/1RsVBd","long_url":"https://example.com/long/path","expires":null}
GET
/api/shorten/{code}
Retrieve short URL metadata including click count.
Examples
Get info
curl https://r3rr.com/api/shorten/1RsVBd
Response
{"ok":true,"code":"1RsVBd","short_url":"https://r3rr.com/1RsVBd","long_url":"https://...","click_count":12,"expires_at":null}Image Upload
POST
/api/image
Upload an image (JPEG, PNG, GIF, WebP — max 10 MB). Must be multipart/form-data.
Fields
| Name | Required | Description |
|---|---|---|
| image | required | Image file |
| expiry | optional | Seconds: 0, 3600, 86400, 604800, 2592000 |
Examples
Upload file
curl -F 'image=@photo.jpg' https://r3rr.com/api/image
With expiry
curl -F 'image=@screenshot.png' -F 'expiry=86400' https://r3rr.com/api/image
Upload from stdin
cat image.png | curl -F 'image=@-;type=image/png' https://r3rr.com/api/image
Response
{"ok":true,"code":"UNW2bX","url":"/image/UNW2bX","raw_url":"/image/UNW2bX/raw","mime_type":"image/jpeg","file_size":204800,"width":1920,"height":1080,"expires":null}
GET
/api/image/{code}
Retrieve image metadata as JSON.
Examples
Get metadata
curl https://r3rr.com/api/image/UNW2bX
Response
{"ok":true,"code":"UNW2bX","url":"/image/UNW2bX","raw_url":"/image/UNW2bX/raw","mime_type":"image/jpeg","file_size":204800,"width":1920,"height":1080,"view_count":3}Error Responses
| HTTP Status | Meaning |
|---|---|
| 422 Unprocessable | Validation failed — check the "error" field for details |
| 404 Not Found | The requested code does not exist |
| 410 Gone | The resource existed but has expired |
| 429 Too Many Requests | Rate limit exceeded — slow down |
| 500 Server Error | Something went wrong on our end |