v1.0 API Now Live

Agent-Ready Links.
Zero UI Required.

The headless URL shortening infrastructure built for AI agents and developer workflows. Equip your LLMs with a simple, high-speed link generation skill in minutes.

Start Building for Free Read the Docs

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/very/long/path/to/important/document.pdf?token=xyz123abc" }'

# Response

{
  "short_id": "fYolGcAs",
  "original_url": "https://your-app.com/very/long/path/to/important/document.pdf?token=xyz123abc",
  "short_url": "https://zrl.app/fYolGcAs",
  "created_at": "2026-04-05T07:08:56.326888Z"
}

Built for Agentic Workflows.

We skipped the bloated dashboard so we could focus on what matters: instant latency, reliability, and seamless integration for AI and developers.

Sub-50ms Latency

Globally distributed edge infrastructure ensures your links resolve instantly, no matter where your users are located.

100% Free (For Now Only)

No pricing tiers, no credit cards, no hidden fees. Start shortening URLs immediately at zero cost while we are in our early launch phase.

Native AI Tooling

A single, elegant REST endpoint designed perfectly for LLM function calling. Pass us complex URLs and we'll hand back clean short links for your agents to share.

Equip your agents in seconds.

No bloated SDKs to maintain. Our pure REST endpoints fit seamlessly into any codebase, enabling you to build dynamic sharing links or easily equip your AI agents with a URL shortening skill.

AI Agent Ready: Perfect for adding a URL-shortening "Skill" or "Tool" to LLMs and agentic workflows.
Language Agnostic: Native HTTP requests work everywhere—Node.js, Python, Go, and beyond.
OpenAPI Spec: Easily import into Postman or auto-generate typed clients if needed.

Explore full API reference

const response = await fetch('https://api.zrl.app/api/v1/short-urls', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${process.env.ZRL_KEY}`
  },
  body: JSON.stringify({
    original_url: 'https://your-app.com/very/long/path...'
  })
});

const data = await response.json();
console.log(data.short_url);
// => "https://zrl.app/fYolGcAs"

import os
import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.environ.get('ZRL_KEY')}"
}

payload = {
    "original_url": "https://your-app.com/very/long/path..."
}

response = requests.post(
    "https://api.zrl.app/api/v1/short-urls", 
    json=payload, 
    headers=headers
)

print(response.json()["short_url"])
# => "https://zrl.app/fYolGcAs"

package main

import (
    "bytes"
    "fmt"
    "net/http"
    "os"
)

func main() {
    url := "https://api.zrl.app/api/v1/short-urls"
    payload := []byte(`{"original_url":"https://your-app.com/..."}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("ZRL_KEY"))

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    fmt.Println("Status:", resp.Status)
}

---
name: short-url
description: Create short links from long URLs. Use when a URL is too long for chat, sharing signed URLs, or whenever a reusable short link is preferable.
---

# Short URL Skill

Use this skill to shorten long URLs before sharing them in chat or reports.

## Workflow
1. Send the long URL to the short-url service.
2. Capture the returned short URL.
3. Share the short URL instead of the raw long URL.

## Command
```bash
curl -X POST '[https://api.zrl.app/api/v1/short-urls](https://api.zrl.app/api/v1/short-urls)' \
 -H 'Content-Type: application/json' \
 -H 'Authorization: Bearer YOUR_API_KEY' \
 -d '{
 "original_url": "[https://your-app.com/some/very/long/path](https://your-app.com/some/very/long/path)"
 }'
```

## Output Expectations
- Return the short URL cleanly.
- Never echo the Bearer token in chat replies.