pyreqwest-impersonate

0.5.3 verified Fri May 01 auth: no python

HTTP client that can impersonate web browsers, mimicking their headers and TLS/JA3/JA4/HTTP2 fingerprints. Version 0.5.3, actively developed.

pip install pyreqwest-impersonate

Common errors

error AttributeError: module 'pyreqwest_impersonate' has no attribute 'impersonate' ↓

cause Using old import pattern `from pyreqwest_impersonate import impersonate` on version <0.4.0 where the function does not exist.

fix

Upgrade to latest version: pip install --upgrade pyreqwest-impersonate

error TypeError: impersonate() got an unexpected keyword argument 'impersonate' ↓

cause Using `impersonate` as the parameter name for the profile; older versions used `browser`.

fix

Change to browser='chrome' if on version <0.5.0, or update library.

error ImportError: cannot import name 'ImpersonateSession' from 'pyreqwest_impersonate' ↓

cause `ImpersonateSession` was removed in 0.5.0.

fix

Use impersonate function instead: from pyreqwest_impersonate import impersonate

Warnings

breaking In version 0.4.0, the main API changed from class-based `ImpersonateSession` to a function-based `impersonate`. Old code using `ImpersonateSession` will break. ↓

fix Replace `session = ImpersonateSession(); session.get(url)` with `impersonate(url, impersonate='chrome')`.

gotcha Impersonation is not exact; some websites may still detect the library due to missing or differing HTTP/2 settings. ↓

fix Test with target site and consider adjusting headers or using a different impersonation profile.

deprecated The `headers` parameter in `impersonate()` is being deprecated in favor of a separate `headers` dictionary passed to the underlying `requests` call. ↓

fix Pass headers via `requests.Session` or use `impersonate(url, headers=...)` but note deprecation.

Imports

impersonate

wrong

from pyreqwest_impersonate import ImpersonateSession

correct

from pyreqwest_impersonate import impersonate

Class name changed in 0.4.0; use the function directly

ImpersonateSession

wrong

from pyreqwest_impersonate import Session

correct

from pyreqwest_impersonate import ImpersonateSession

Old import path removed in 0.5.0

Quickstart

Basic request with Chrome impersonation.

import os
from pyreqwest_impersonate import impersonate

url = 'https://httpbin.org/headers'
response = impersonate(url, impersonate='chrome', headers={'User-Agent': os.environ.get('USER_AGENT', 'Mozilla/5.0')})
print(response.text)