Python SDK

pip install dub

from dub import Dub
import os

dub = Dub(
    token=os.environ.get("DUB_API_KEY")
)

from dub import Dub
import os

dub = Dub(token=os.environ.get("DUB_API_KEY"))

link = dub.links.create(
    url="https://example.com/long-url",
    domain="your-domain.com",
    key="custom-key"
)

print(link.short_link)  # https://your-domain.com/custom-key

links = dub.links.list(
    search="example",
    page_size=10
)

for link in links.result:
    print(f"{link.short_link} -> {link.url}")
    print(f"Clicks: {link.clicks}")
    print(f"Created: {link.created_at}")

updated_link = dub.links.update(
    link_id="clx1...",
    url="https://example.com/new-destination"
)

dub.links.delete(link_id="clx1...")

domains = dub.domains.list()

for domain in domains.result:
    print(domain.slug)

domain = dub.domains.get(slug="your-domain.com")
print(f"Domain: {domain.slug}")
print(f"Verified: {domain.verified}")

customers = dub.customers.list(
    external_id="user_123",
    include_expanded_fields=True
)

customer = customers[0] if len(customers) > 0 else None

dub.track.lead(
    click_id=dub_id,
    event_name="Sign Up",
    customer_external_id="user_123",
    customer_name="John Doe",
    customer_email="[email protected]",
    customer_avatar="https://example.com/avatar.jpg"
)

dub.track.sale(
    click_id=dub_id,
    event_name="Purchase",
    customer_external_id="user_123",
    amount=99.99,
    currency="USD",
    metadata={
        "order_id": "order_456",
        "product_id": "prod_789"
    }
)

try:
    link = dub.links.create(
        url="https://example.com",
        domain="your-domain.com"
    )
except Exception as e:
    print(f"Failed to create link: {e}")

from dub import Dub
from dub.models import Link, Domain

dub = Dub(token=os.environ.get("DUB_API_KEY"))

link: Link = dub.links.create(
    url="https://example.com"
)