wreq 0.12.0

An ergonomic Python HTTP Client with TLS fingerprint

wreq

🚀 Help me work seamlessly with open source sharing by sponsoring me on GitHub

An ergonomic and modular Python HTTP Client for high-fidelity protocol matching, featuring customizable TLS, JA3/JA4, and HTTP/2 signature capabilities, powered by wreq.

Features

• Async and Blocking Clients
• Plain bodies, JSON, urlencoded, multipart
• HTTP Trailer
• Cookie Store
• Redirect Policy
• Original Header
• Rotating Proxies
• Connection Pooling
• Streaming Transfers
• Zero-Copy Transfers
• WebSocket Upgrade
• HTTPS via BoringSSL
• Free-Threaded Safety
• Automatic Decompression
• Certificate Store (CAs & mTLS)

Example

The following example uses the asyncio runtime with wreq installed via pip:

pip install wreq

And then the code:

import asyncio
from wreq import Client, Emulation


async def main():
    # Build a client
    client = Client(emulation=Emulation.Firefox149)

    # Use the API you're already familiar with
    resp = await client.get("https://tls.peet.ws/api/all")
    print(await resp.text())


if __name__ == "__main__":
    asyncio.run(main())

Additional learning resources include:

• Examples
• DeepWiki
• Documentation

Behavior

1. HTTP/2 over TLS

Due to the complexity of TLS encryption and the widespread adoption of HTTP/2, browser fingerprints such as JA3, JA4, and Akamai cannot be reliably emulated using simple fingerprint strings. Instead of parsing and emulating these string-based fingerprints, wreq provides fine-grained control over TLS and HTTP/2 extensions and settings for precise browser behavior emulation.

2. Device Emulation

TLS and HTTP/2 fingerprints are often identical across various browser models because these underlying protocols evolve slower than browser release cycles. 100+ browser device emulation profiles are maintained in wreq.

Building

1. Platforms

• Linux(glibc/musl): x86_64, aarch64, armv7, i686
• macOS: x86_64,aarch64
• Windows: x86_64,i686,aarch64
• Android: aarch64, x86_64

2. Development

Install the BoringSSL build environment by referring to boringssl.

# on ubuntu or debian
sudo apt install -y build-essential cmake perl pkg-config libclang-dev musl-tools git
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
pip install uv maturin

uv venv
source .venv/bin/activate

# development
maturin develop --uv

# build wheels
maturin build --release

Benchmark

Outperforms requests, httpx, aiohttp, and curl_cffi according to our benchmark suite driven by pyperf, though results are for reference only as they vary by environment.

Services

Help sustain the ongoing development of this open-source project by reaching out for commercial support. Receive private guidance, expert reviews, or direct access to the maintainer, with personalized technical assistance tailored to your needs.

License

Licensed under either of Apache License, Version 2.0 (LICENSE or http://www.apache.org/licenses/LICENSE-2.0).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.

Sponsors

Scrape.do is the ultimate toolkit for collecting public data at scale. Unmatched speed, unbeatable prices, unblocked access.

One line of code. Instant data access

Automatic Proxy Rotation • Bypass Anti-bot Solutions • Seamless Web Scraping

Dashboard | Linkedin | Docs

---

Captcha solving can be slow and unreliable, but EzCaptcha delivers fast, reliable solving through a simple API — supporting a wide range of captcha types with no complex integration required.

ReCaptcha • FunCaptcha • CloudFlare • Akamai • AkamaiSbsd • HCaptcha

Designed for developers, it offers high accuracy, low price, low latency, and easy integration, helping you automate verification while keeping traffic secure and user flows smooth.

Dashboard | Docs | Telegram

---

RapidProxy delivers fast, reliable proxy infrastructure for large-scale data operations. With high concurrency, non-expiring traffic, and AI-powered CAPTCHA bypass, it ensures efficient, uninterrupted data collection—trusted by developers worldwide.

90M+ Residential IPs • Smart Rotation • High Success Rate • Built for Scale

Special Offer: Try it free — Pricing from $0.65/GB with non-expiring traffic. Use code RAPID10 for 10% off.

Website | Linkedin | Telegram

---

Swiftproxy powers your web scraping with reliable residential proxies, giving you access to a dependable pool of residential IPs for efficient data extraction while delivering high success rates, anti-ban protection, and automatic rotation at scale.

Global Residential IPs • Auto Rotation • Anti-Ban • Scraping at Scale

Exclusive Offer: Get 500MB free trial traffic + an exclusive 10% OFF code: PROXY90

Linkedin | Discord | Telegram

---

TLS fingerprinting alone isn't enough for modern bot protection. Hyper Solutions provides the missing piece - API endpoints that generate valid antibot tokens for:

Akamai • DataDome • Kasada • Incapsula

No browser automation. Just simple API calls that return the exact cookies and headers these systems require.

Dashboard | Docs | Discord