LeonAI Links API
The LeonAI Links API is a REST API for creating and managing short links, reading click analytics, tracking conversions, generating QR codes, managing custom domains and webhooks, and building link-in-bio pages.
It's the same API that powers the LeonAI dashboard, and it's built developer-first: an OpenAPI 3.1 spec and predictable versioned responses. TypeScript and Python SDKs, an MCP server for AI assistants, and Zapier and Make.com apps and a browser extension are on the way (not published yet).
Base URL
https://api.short.leonai.io
All endpoints live under the versioned prefix /api/v1. For example:
POST https://api.short.leonai.io/api/v1/links
GET https://api.short.leonai.io/api/v1/analytics/:linkId
Short links themselves are served from the redirect host (for example
https://short.leonai.io/spring-sale), which also serves public QR images at
GET /:shortCode/qr.
What you can do
| Area | Highlights |
|---|---|
| Links | Create with custom back-halves, UTM params, tags, expiry; list/search; update; bulk import (up to 1000); export |
| Analytics | Timelines and device/browser/OS/country/referrer breakdowns, real-time (last hour), CSV export |
| Conversions | Revenue attribution via the lc_id click flow (Business+) |
| QR codes | Public dynamic QR images (PNG / SVG / data URL) |
| Domains | Branded domains — one-click Cloudflare auto-connect or manual DNS verification |
| Webhooks | Subscribe to link/domain/subscription events with HMAC-signed deliveries |
| Bio pages | Build and publish link-in-bio landing pages |
| Smart routing | Geo / device / time / A-B rules per link (Business+) |
| AI | Slug suggestions, link insights (Business+), anomaly detection |
| Billing | Subscriptions, invoices, and VAT via Sumit (OfficeGuy), in USD |
| Teams | Multi-user collaboration with RBAC roles |
Authentication in one line
Send an API key as an X-API-Key header, or a JWT as Authorization: Bearer <token>.
See Authentication for scopes, key creation, and rate limits.
curl https://api.short.leonai.io/api/v1/links \
-H "X-API-Key: lk_live_..."
Subscription tiers
Feature access and quotas are enforced per subscription tier. Billing runs on Sumit (OfficeGuy) in US dollars (USD). List prices are ex-VAT; Sumit adds 18% Israeli VAT and issues a tax invoice/receipt (חשבונית מס/קבלה). Annual billing saves 20%. See the Billing guide.
| Tier | Price (ex-VAT) | Notable limits |
|---|---|---|
| Free | $0 | 100 links/mo, 5k clicks tracked, 1 custom domain, 30-day retention, 100 API req/day, 1 bio page, no webhooks |
| Pro | $19/mo ($180/yr) | 1,000 links/mo, 50k clicks, 5 domains, 1-year retention, 10k API req/day, 5 webhooks, 3 bio pages, password + expiry, custom back-half |
| Business | $79/mo ($756/yr) | 10,000 links/mo, 500k clicks, 25 domains, 3-year retention, 100k API req/day, 25 webhooks, 10 bio pages, A/B, conversions, smart routing, AI insights, SSO |
| Enterprise | $299/mo ($2,868/yr) | Unlimited links/clicks/domains, unlimited retention, 1M API req/day, unlimited webhooks & bio pages, white-label, SLA |
Endpoints that require a paid tier are marked (for example, Business+) in the
guides. When a tier limit or feature gate is exceeded, the API returns a 403 with an
explanatory message — see Errors.
Next steps
- Authentication — API keys, scopes, JWT, and rate limits
- Quickstart — create your first link with curl
- Guides — task-focused walkthroughs
- API Reference — the full OpenAPI spec and Swagger UI