# LeonAI Links API

Source: https://developers.leonai.io/docs/intro/

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](https://developers.leonai.io/docs/sdks/),
an [MCP server](https://developers.leonai.io/docs/mcp-server/) for AI assistants, and [Zapier and Make.com apps and a
browser extension](https://developers.leonai.io/docs/integrations/) 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](https://developers.leonai.io/docs/authentication/) for scopes, key creation, and rate limits.

```bash
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](https://developers.leonai.io/docs/guides/billing/).

| 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](https://developers.leonai.io/docs/errors/).

## Next steps

- [Authentication](https://developers.leonai.io/docs/authentication/) — API keys, scopes, JWT, and rate limits
- [Quickstart](https://developers.leonai.io/docs/quickstart/) — create your first link with curl
- [Guides](https://developers.leonai.io/docs/guides/links/) — task-focused walkthroughs
- [API Reference](https://developers.leonai.io/docs/api-reference/) — the full OpenAPI spec and Swagger UI