---
id: ada-url
version: "4.0.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# ada-url — URL parser and manipulator based on the WHAT WG URL standard

License: permissive · Maintenance: active · Downloads: 464.9K/mo

## What it is and what it does

ada-url is a Python binding to the Ada URL parser, a C library that implements the WHATWG URL standard. It provides three main interfaces: the URL class for object-oriented URL manipulation, parse_url for extracting all URL components into a dictionary, and URLSearchParams for handling query strings. The library also includes idna encoding/decoding for internationalized domain names.

Unlike Python's standard urllib.parse, which follows the older RFC 3978 standard, ada-url correctly normalizes paths (resolving . and ..), properly encodes international characters in domain names, and handles edge cases defined by the WHATWG spec. It uses CFFI to call the underlying C library, making it faster than pure-Python alternatives for most URL parsing tasks. The package depends only on cffi and supports Python 3.10 and later across macOS, Linux, and Windows.

Use it for:

- Validate and normalize user-supplied URLs in web applications before storing or processing them.
- Extract and manipulate URL components (hostname, path, query parameters) in web scrapers or API clients.
- Parse and handle internationalized domain names (IDNs) in multilingual applications.
- Resolve relative URLs and normalize paths in document processing or link crawling.
- Build query strings and search parameters programmatically with URLSearchParams.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parse, validate, and manipulate URLs according to the WHATWG URL standard, with support for internationalized domain names and path normalization.

Yes, if you need WHATWG-compliant URL parsing. The library is actively maintained, has no known vulnerabilities, and offers standards compliance and performance benefits over urllib.parse. Install friction is moderate due to compiled wheels, but prebuilt binaries cover current Python versions and common platforms. The Apache-2.0 license is permissive. Suitable for production use in web applications, API clients, and data processing pipelines.

## Install

pip install ada-url
uv add ada-url
poetry add ada-url

## Installing ada-url

Before you install: Medium install friction due to compiled wheels; prebuilt binaries are available for current Python versions (3.10+) and common platforms, but installation requires a C compiler if building from source. Actively maintained with recent releases.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install ada_url

from ada_url import URL, parse_url
url = URL('https://example.org/path/../file.txt')
print(url.href)  # 'https://example.org/path/file.txt'

result = parse_url('https://user:pass@example.org:80/api?q=1#2')
print(result['hostname'])  # 'example.org'

Requires Python 3.10 or later.

Verify before relying:

- Actual performance comparison with urllib.parse under typical workloads remains unquantified in the fact sheet.
- Whether CFFI dependency introduces runtime overhead or platform-specific compatibility issues beyond the prebuilt wheels.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 464.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

url parsing whatwg standard, url validation and manipulation, internationalized domain names, fast url parser, url path normalization, url component extraction, search parameters parsing, url-parsing, whatwg-standard, internationalization

[View on SkillFed](https://skillfed.io/packages/ada-url) · [View on PyPI](https://pypi.org/project/ada-url/)