REST API Reference · v1

Developer REST API

Automate short link creation, editing, bulk imports, and analytics from any application or CI pipeline. Generate an API key in your Dashboard → API Keys.

Authentication & Quotas

Pass your secret key in the Authorization header on any endpoint under https://zlink.bond/api:

Authorization: Bearer zlk_your_api_key_here
Content-Type: application/json

Daily API quota: 200 requests/day on Free · 25,000 requests/day on Pro.

POST /api/links — Create a short link

curl -X POST https://zlink.bond/api/links \
  -H "Authorization: Bearer zlk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product-launch",
    "alias": "launch-2026",
    "title": "Q2 Launch",
    "tags": ["marketing", "social"],
    "expires_at": "2026-12-31T23:59:59Z"
  }'

GET /api/links — List & search your links

curl "https://zlink.bond/api/links?page=1&limit=20&q=launch&tag=marketing" \
  -H "Authorization: Bearer zlk_..."

GET /api/links/:id/stats — Click analytics

Query parameter days supports up to 30 days on Free and 365 days on Pro (which also returns referrers, devices, browsers, and os).

curl "https://zlink.bond/api/links/lnk_abc123/stats?days=30" \
  -H "Authorization: Bearer zlk_..."

PATCH /api/links/:id & DELETE /api/links/:id

curl -X PATCH https://zlink.bond/api/links/lnk_abc123 \
  -H "Authorization: Bearer zlk_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/updated", "disabled": false }'

POST /api/links/bulk — Bulk create Pro

Create up to 100 short links in a single request:

curl -X POST https://zlink.bond/api/links/bulk \
  -H "Authorization: Bearer zlk_..." \
  -H "Content-Type: application/json" \
  -d '{ "links": [{ "url": "https://example.com/1" }, { "url": "https://example.com/2", "alias": "two" }] }'

GET /qr/:alias — Vector QR code

Public SVG endpoint supporting custom hex colors and download headers:

https://zlink.bond/qr/launch-2026?fg=%230a0a0a&bg=%23ffffff&download=1