dub

What it is and what it does

Dub is an official Python client for the Dub.co API, a link attribution and conversion tracking platform. It wraps Dub's REST API to let you create short links, manage tags and domains, retrieve analytics, handle affiliate commissions, and run A/B tests on link variants—all from Python code. The SDK supports both synchronous and asynchronous workflows via context managers, and uses pydantic for request/response validation and httpx for HTTP transport.

The package targets Python 3.10 and later. It depends on httpcore, httpx, jsonpath-python, and pydantic. Installation is straightforward via pip, uv, or poetry, and the SDK is designed to work with Dub API authentication tokens. It includes built-in support for retries, pagination, custom HTTP clients, and error handling.

Use it for:

• Create and manage short links programmatically for marketing campaigns or affiliate tracking.
• Retrieve click and conversion analytics for links to measure campaign performance.
• Manage affiliate commissions and bounty submissions within your application.
• Run A/B tests by creating link variants with specified traffic percentages.
• Integrate Dub link tracking into a backend service or automation workflow.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Dub is a Python SDK for the Dub.co link attribution platform, providing programmatic access to create, manage, and track short links, conversion data, and affiliate programs.

Yes, if you use Dub.co for link management or affiliate tracking and need programmatic access from Python. The package is actively maintained, has low install friction, and supports current Python versions. However, verify the license terms before use in commercial or compliance-sensitive projects, since the license status is currently unclear in the metadata.

Install

dub on PyPI

pip install dub

uv add dub

poetry add dub

Installing dub

Before you install

Low install friction with a pure-Python wheel distribution. The package is actively maintained with a recent release (40 days old) and supports current Python versions (3.10–3.14). Four runtime dependencies (httpcore, httpx, jsonpath-python, pydantic) are all stable, widely-used libraries.

License in practice

License status is unclear—no SPDX identifier or raw license text is declared in the package metadata. Before adopting in a commercial or compliance-sensitive context, verify the actual license terms directly from the repository.

Quickstart

pip install dub

from dub import Dub

with Dub(token="DUB_API_KEY") as client:
    res = client.links.create(request={
        "url": "https://google.com",
        "external_id": "123456"
    })
    print(res)

Requires Python 3.10 or later and a valid Dub API token.

Verify before relying

• Whether the package is generated by Speakeasy tooling and how that affects maintenance or API stability guarantees.
• Actual license terms, given the unclear license_treatment in metadata.

Package facts

Evidence: dub-0.37.1-py3-none-any.whl

Tags

More WWW/HTTP packages