API First • Agent-ready short URL

Short links built for apps, automations, and agents.

Zrl.app gives you an API First short URL service with a contract that fits cleanly into backend code, workflow tools, and LLM actions. Send a long URL, get a short URL back, and move on.

Simple bearer-auth HTTP API Works in product code and agent tools Fast onboarding via portal.zrl.app

GET API KEY SEE EXAMPLES

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

Made for shipping fast, not babysitting a link shortener.

Zrl.app stays narrow on purpose: one reliable endpoint, predictable output, and clean docs your app team or agent runtime can use immediately.

Built for real delivery flows

Use it where links actually get handed off.

1 endpoint · fast integration

Reports, chat replies, signed asset delivery, internal tools, and agent actions all need the same thing: a clean short URL you can trust and return right away.

JSON simple request/response contract

Bearer auth easy to wire into services and automations

No SDK lock-in works with whatever already ships in your stack

⚡

Fast path

HTTP in, short link out

No extra platform ceremony. Post a long URL, get back a short URL, and continue the workflow.

🤖

Agent fit

Predictable enough for tool-calling

The API shape is easy for LLM tools, backend jobs, cron flows, and internal bots to consume safely.

🧩

Drop-in

Works with your existing stack

Use fetch, requests, Go net/http, Java HttpClient, or any JSON-capable runtime.

Document

Drop Zrl.app into your stack in a few minutes.

Keep the integration lightweight: issue an API key, call one endpoint, and return the resulting short URL to your UI, your backend jobs, or your agent runtime.

Simple HTTP API for apps, scripts, and agent tools
Examples for Node.js, Python, Go, Java, and Tool.md-style agent docs
Aligned with AI tool calling, internal automation, and report sharing workflows

Examples

Request examples

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.

GET API KEY READ DOCUMENT

Short links built for apps, automations, and agents.

Made for shipping fast, not babysitting a link shortener.

Use it where links actually get handed off.

HTTP in, short link out

Predictable enough for tool-calling

Works with your existing stack

Drop Zrl.app into your stack in a few minutes.

Request examples

Get your key and ship the integration.

Terms of Service

1. Acceptance

2. Use of service

3. API keys and account security

4. Submitted URLs and content responsibility

5. Service availability and changes

6. Disclaimer and limitation of liability

7. Contact

Privacy Policy

1. Data we collect

2. How data is used

3. Retention

5. Security

6. Your choices

7. Updates

Short links built for apps, automations, and agents.

Made for shipping fast, not babysitting a link shortener.

Use it where links actually get handed off.

HTTP in, short link out

Predictable enough for tool-calling

Works with your existing stack

Drop Zrl.app into your stack in a few minutes.

Request examples

Get your key and ship the integration.

Terms of Service

1. Acceptance

2. Use of service

3. API keys and account security

4. Submitted URLs and content responsibility

5. Service availability and changes

6. Disclaimer and limitation of liability

7. Contact

Privacy Policy

1. Data we collect

2. How data is used

3. Retention

4. Sharing and disclosure

5. Security

6. Your choices

7. Updates