Skip to content

curl-cffi

6,871 5 55 MIT
0.17.0 (26 Oct 2026) Feb 23 2022 34.9 million (month)

Curl-cffi is a Python library for implementing curl-impersonate which is a HTTP client that appears as one of popular web browsers like: - Google Chrome - Microsoft Edge - Safari - Firefox Unlike requests and httpx which are native Python libraries, curl-cffi uses cURL and inherits it's powerful features like extensive HTTP protocol support and detection patches for TLS and HTTP fingerprinting.

Using curl-cffi web scrapers can bypass TLS and HTTP fingerprinting.

Highlights


bypasshttp2tls-fingerprinthttp-fingerprintsyncasync

Example Use


curl-cffi can be accessed as low-level curl client as well as an easy high-level HTTP client:

from curl_cffi import requests

response = requests.get('https://httpbin.org/json')
print(response.json())

# or using sessions
session = requests.Session()
response = session.get('https://httpbin.org/json')

# also supports async requests using asyncio
import asyncio
from curl_cffi.requests import AsyncSession

urls = [
  "http://httpbin.org/html",
  "http://httpbin.org/html",
  "http://httpbin.org/html",
]

async with AsyncSession() as s:
    tasks = []
    for url in urls:
        task = s.get(url)
        tasks.append(task)
    # scrape concurrently:
    responses = await asyncio.gather(*tasks)

# also supports websocket connections
from curl_cffi.requests import Session, WebSocket

def on_message(ws: WebSocket, message):
    print(message)

with Session() as s:
    ws = s.ws_connect(
        "wss://api.gemini.com/v1/marketdata/BTCUSD",
        on_message=on_message,
    )
    ws.run_forever()

Alternatives / Similar


7,191 v0.6.1 (2024-03-02 18:08:29 ago) Feb 23 2022 compare
632 2.0.1 (2026-09-13 00:17:31 ago) Jun 01 2024 compare
1,024 0.9.2 (2024-12-01 02:55:27 ago) Feb 23 2022 compare
54,706 2.34.2 (2026-05-14 19:25:26 ago) Feb 14 2011 compare
15,792 0.28.1 (2024-12-06 15:37:21 ago) Jul 26 2019 compare
16,607 3.14.5 (2026-10-11 00:59:07 ago) Jul 26 2019 compare
1,170 7.49.0 (2026-10-27 01:32:05 ago) Feb 25 2003 compare
12,907 3.5.5 (2024-02-17 17:18:36 ago) Sep 04 2020 compare
13,281 0.5.9 (2026-11-01 06:22:04 ago) Mar 01 2024 compare
4,939 0.50.99 (2026-10-26 13:47:46 ago) Jan 15 2024 compare
604 26.7.0 (2026-07-02 00:07:52 ago) Dec 28 2012 compare
7,142 3.0.1 (2026-11-08 11:38:44 ago) Jun 01 2024 compare
5,842 4.0.97 (2026-01-06 07:45:54 ago) Oct 01 2023 compare
859 1.9.4 (2024-10-22 01:41:19 ago) Jul 22 2022 compare

Other Languages

8,845 3.3.2 (2023-11-30 14:10:12 ago) Dec 28 2012 compare
109,391 1.21.1 (2026-11-09 16:17:55 ago) Aug 29 2014 compare
got
14,963 16.2.0 (2026-10-30 08:49:15 ago) Mar 27 2014 compare
16,639 10.4.2 (2026-11-07 09:09:17 ago) Aug 22 2011 compare
1,636 3.5.0 (2026-04-24 23:30:41 ago) Dec 11 2011 compare
5,956 2.15.1 (2026-10-26 10:01:47 ago) Dec 19 2009 compare
95,840 2.11.2 (2023-04-11 04:13:00 ago) May 29 2018 compare
1,177 1.12.0 (2026-11-10 16:05:20 ago) Oct 31 2009 compare
709 2.10.0 (2026-10-31 07:08:04 ago) Jul 25 2009 compare
7,421 3.3.6 (2023-03-01 12:19:02 ago) May 15 2018 compare
5,900 0.24.3 (2026-09-30 12:38:56 ago) Jul 25 2009 compare
4,137 1.7.1 (2026-10-28 18:28:21 ago) Oct 06 2009 compare
983 1.4.9 (2026-09-01 15:20:00 ago) May 06 2012 compare
23,443 8.5.0 (2026-11-13 03:12:32 ago) Nov 14 2011 compare
2,030 v8.2.0-BETA2 (2026-11-13 13:50:34 ago) Apr 28 2019 compare
1,525 1.0.5 (2026-07-09 06:54:00 ago) Nov 22 2014 compare
1,215 1.1.7 (2020-08-31 21:38:00 ago) Oct 25 2009 compare
375 18.1.0 (2025-07-24 23:01:15 ago) Aug 06 2011 compare
908 1.3.0 (2026-10-14 11:01:05 ago) Sep 25 2013 compare
4,444 2.14.2 (2026-10-26 20:34:30 ago) Jul 25 2009 compare
505 1.1.4 (2020-02-07 22:04:51 ago) Apr 20 2010 compare
11,831 v3.0.0-rc.4 (2026-09-06 18:31:59 ago) Sep 26 2024 compare
req
4,872 v3.61.0 (2026-08-13 08:32:36 ago) Apr 08 2024 compare
3,570 v2.0.21 (2026-10-20 19:26:33 ago) Oct 06 2013 compare
108 1.6.0 (2026-07-09 07:29:00 ago) Nov 09 2016 compare
1,915 1.4.0 (2026-05-15 12:02:31 ago) Nov 11 2011 compare
1,765 1.0.0 (2024-05-01 11:33:16 ago) Apr 14 2012 compare
165 2.3.0 (2026-07-09 06:48:00 ago) Dec 22 2019 compare
3,084 1.7.1 (2026-11-03 07:39:59 ago) Mar 20 2015 compare
Was this page helpful?