Advanced Usage¶

Low-level curl API¶

Alternatively, you can use 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("chrome124")

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

Scrapy integrations¶

If you are using scrapy, check out these middlewares:

[tieyongjie/scrapy-fingerprint](https://github.com/tieyongjie/scrapy-fingerprint)
[jxlil/scrapy-impersonate](https://github.com/jxlil/scrapy-impersonate)

Using with eventlet/gevent¶

Just set thread to eventlet or gevent.

from curl_cffi import requests

s = requests.Session(thread="eventlet")
s.get(url)

As a urllib3/requests adapter¶

You can also use curl-cffi as a requests adapter via curl-adapter. In this way, you get the full functionality of requests.

import requests
from curl_adapter import CurlCffiAdapter

session = requests.Session()
session.mount("http://", CurlCffiAdapter())
session.mount("https://", CurlCffiAdapter())

# just use requests session like you normally would
session.get("https://example.com")

As a httpx transport¶

You can also use curl-cffi as a httpx transport via httpx-curl-cffi. With this, you get the full functionality of httpx.

from httpx import Client, AsyncClient
from httpx_curl_cffi import CurlTransport, AsyncCurlTransport, CurlOpt

client = Client(transport=CurlTransport(impersonate="chrome", default_headers=True))
client.get("https://tools.scrapfly.io/api/fp/ja3")

async_client = AsyncClient(transport=AsyncCurlTransport(
    impersonate="chrome",
    default_headers=True,
    # required for parallel requests, see curl_cffi issues below
    curl_options={CurlOpt.FRESH_CONNECT: True}
))