curl-cffi 0.2.4

libcurl ffi bindings for Python, with impersonation support

curl_cffi

Python binding for curl-impersonate via CFFI.

Unlike other pure python http clients like httpx or requests, this package can impersonate browsers' TLS signatures or JA3 fingerprints. If you are blocked by some website for no obvious reason, you can give this package a try.

Install

pip install --upgrade curl_cffi

This should work for Linux(x86_64/aarch64), macOS(Intel), Windows(amd64). If it does not work, you may need to compile and install curl-impersonate first.

Usage

requests/httpx-like API:

from curl_cffi import requests

# Notice the impersonate parameter
r = requests.get("https://tls.browserleaks.com/json", impersonate="chrome101")

print(r.json())
# output: {'ja3_hash': '53ff64ddf993ca882b70e1c82af5da49'
# the fingerprint should be the same as target browser

For a list of supported impersonation versions, please check the curl-impersonate repo.

Or, the low-level curl-like API:

from curl_cffi import Curl, CurlOpt
from io import BytesIO

buffer = BytesIO()
c = Curl()
c.setopt(CurlOpt.URL, b'https://tls.browserleaks.com/json')
c.setopt(CurlOpt.WRITEDATA, buffer)

c.impersonate("chrome101")

c.perform()
c.close()
body = buffer.getvalue()
print(body.decode())

See example.py or tests/ from more examples.

API

Requests: almost the same as requests.

Curl object:

• setopt(CurlOpt, value): Sets curl options as in curl_easy_setopt
• perform(): Performs curl request, as in curl_easy_perform
• getinfo(CurlInfo): Gets information in response after curl perform, as in curl_easy_getinfo
• close(): Closes and cleans up the curl object, as in curl_easy_cleanup

Enum values to be used with setopt and getinfo can be accessed from CurlOpt and CurlInfo.

Current Status

This implementation is very hacky now, but it works for most common systems.

When people installing other python curl bindings, like pycurl, they often face compiling issues or OpenSSL issues, so I really hope that this package can be distributed as a compiled binary package, uses would be able to use it by a simple pip install, no more compile errors.

For now, I just download the pre-compiled libcurl-impersonate from github and build a bdist wheel, which is a binary package format used by PyPI, and upload it. However, the right way is to download curl and curl-impersonate sources on our side and compile them all together.

Help wanted!

TODOs:

• Write docs.
• Binary package for macOS(Intel) and Windows.
• Support musllinux(alpine) and macOS(Apple Silicon) bdist by building from source.
• Exclude the curl headers from source, download them when building.
• Update curl header files and constants via scripts.
• Implement requests.Session/httpx.Session.
• Create ABI3 wheels to reduce package size and build time.

Acknowledgement

This package was originally forked from https://github.com/multippt/python_curl_cffi