Fast integration
One call to ship
Post a long URL, receive a short URL, and keep the workflow moving without extra platform setup.
API First • Agent-ready short URL
Short links for apps, automations, and agents.
Zrl.app keeps it simple: send one long URL to one clean endpoint and get a short URL back.
Bearer-auth JSON API
Fits app code and agent tools
Get started from portal.zrl.app
bash ~ curl
$ curl --location 'https://api.zrl.app/api/v1/short-urls' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"original_url": "https://your-app.com/reports/april-summary?token=xyz123abc"
}'
# Response
{
"short_id": "fYolGcAs",
"original_url": "https://your-app.com/reports/april-summary?token=xyz123abc",
"short_url": "https://zrl.app/fYolGcAs",
"created_at": "2026-04-05T07:08:56.326888Z"
}Why teams pick Zrl.app
Three reasons it earns a place in the stack.
Zrl.app stays intentionally narrow: one endpoint, predictable output, and docs that are easy to copy into product code or agent tooling.
Agent-ready
Predictable for automation
The request and response shape works cleanly in backend jobs, internal tools, and tool-calling agents.
Stack-friendly
No SDK lock-in
Use plain HTTP from Node.js, Python, Go, Java, or whatever already runs in your environment.
Document
Everything you need is one request.
Create a key, call POST /api/v1/short-urls, and use the returned short_url anywhere you need a compact link.
- Single endpoint to create a short URL
- Bearer auth with plain JSON request/response
- Ready-to-copy examples for common runtimes
Request examples
Use the same endpoint from any stack
Language
const response = await fetch('https://api.zrl.app/api/v1/short-urls', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
body: JSON.stringify({
original_url: 'https://example.com/reports/april-summary'
})
});
const data = await response.json();
console.log(data.short_url);import requests
response = requests.post(
'https://api.zrl.app/api/v1/short-urls',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'original_url': 'https://example.com/reports/april-summary'
}
)
print(response.json()['short_url'])payload := strings.NewReader(`{"original_url":"https://example.com/reports/april-summary"}`)
req, _ := http.NewRequest(http.MethodPost, "https://api.zrl.app/api/v1/short-urls", payload)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create("https://api.zrl.app/api/v1/short-urls"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(
"{\"original_url\":\"https://example.com/reports/april-summary\"}"
))
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());# Tool.md
## create_short_url
Create an agent-ready short URL for a long destination.
### request
POST https://api.zrl.app/api/v1/short-urls
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"original_url": "https://example.com/reports/april-summary"
}
### response
{
"short_url": "https://zrl.app/fYolGcAs"
}Start fast
Get your key and ship the integration.
Keep the path short: open portal.zrl.app, issue a key, copy a request example, and wire Zrl.app into your workflow.