u2l

Official Python client for the U2L AI URL shortener API.

Zero dependencies (standard library only). Python 3.9+.

pip install u2l

Quick start

from u2l import U2L

client = U2L(api_key="u2l_live_...")  # free at u2l.ai -> Settings -> API

link = client.links.create(url="https://example.com/some/long/page")
print(link["shortLink"])  # https://u2l.ai/abc1234

Usage

Field names match the API exactly (camelCase) — full schema at u2l.ai/developers/openapi.json.

# Create with options
client.links.create(
    url="https://mysite.com/launch",
    alias="launch24",
    title="Launch day",
    domain="auto",          # or one of your domains
    tags=["campaign"],
    expiresAt="2027-01-01T00:00:00Z",
)

# QR code
client.links.create(url="https://mysite.com", type="QR")

# Get / update / delete (addressed by domain + slug)
client.links.get("u2l.ai", "launch24")
client.links.update("u2l.ai", "launch24", title="Launch day (updated)")
client.links.delete("u2l.ai", "launch24")

# List with filters and pagination
page = client.links.list(search="launch", sort="clicks", order="desc", page=1, limit=25)
for link in page["links"]:
    print(link["shortLink"], link.get("clicks", 0))

# Domains available to your account
client.domains.list()

# Per-link analytics (Advanced+ plans)
client.analytics.get("u2l.ai", "launch24")

# Account info and usage stats
client.account.get()
client.account.stats()

Error handling

Every non-2xx response raises U2LApiError with the API's status, error code, and (on 429s) how long to wait:

from u2l import U2L, U2LApiError

client = U2L(api_key="u2l_live_...")

try:
    client.links.create(url="https://example.com", alias="taken")
except U2LApiError as error:
    print(error.status)       # e.g. 409
    print(error.code)         # e.g. "alias_taken"
    print(error)              # human-readable message
    if error.status == 429:
        print(error.retry_after)  # seconds to wait

Rate limits

After any request, client.rate_limit holds the latest X-RateLimit-* header values:

client.account.get()
print(client.rate_limit)
# {"limit": 10, "remaining": 9, "reset": 1753500000,
#  "daily_limit": 500, "daily_remaining": 499}

Links

• API documentation
• Rate limits per plan
• JavaScript/TypeScript SDK

MIT