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