From 0db0ea21d686b4a578a9906aaccd03604b77d8a2 Mon Sep 17 00:00:00 2001
From: Yifei Kong <kong@yifei.me>
Date: Fri, 28 Jun 2024 00:25:38 +0800
Subject: [PATCH] Update docs

---
 README.md | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index d635082..9a3eeec 100644
--- a/README.md
+++ b/README.md
@@ -74,15 +74,13 @@ To install unstable version from GitHub:
 
 `curl_cffi` comes with a low-level `curl` API and a high-level `requests`-like API.
 
-Use the latest impersonate versions, do NOT copy `chrome110` here without changing.
-
 ### requests-like
 
 ```python
 from curl_cffi import requests
 
 # Notice the impersonate parameter
-r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome110")
+r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome")
 
 print(r.json())
 # output: {..., "ja3n_hash": "aa56c057ad164ec4fdcb7a5a283be9fc", ...}
@@ -93,12 +91,19 @@ print(r.json())
 # Other similar values are: "safari" and "safari_ios"
 r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome")
 
+# To pin a specific version, use version numbers together.
+r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome124")
+
+# To impersonate other than browsers, bring your own ja3/akamai strings
+# See examples directory for details.
+r = requests.get("https://tls.browserleaks.com/json", ja3=..., akamai=...)
+
 # http/socks proxies are supported
 proxies = {"https": "http://localhost:3128"}
-r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome110", proxies=proxies)
+r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome", proxies=proxies)
 
 proxies = {"https": "socks://localhost:3128"}
-r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome110", proxies=proxies)
+r = requests.get("https://tools.scrapfly.io/api/fp/ja3", impersonate="chrome", proxies=proxies)
 ```
 
 ### Sessions
@@ -117,13 +122,16 @@ print(r.json())
 # {'cookies': {'foo': 'bar'}}
 ```
 
-Supported impersonate versions, as supported by my [fork](https://github.com/yifeikong/curl-impersonate) of [curl-impersonate](https://github.com/lwthiker/curl-impersonate):
+`curl_cffi` supports the same browser versions as supported by my [fork](https://github.com/yifeikong/curl-impersonate) of [curl-impersonate](https://github.com/lwthiker/curl-impersonate):
 
 However, only Chrome-like browsers are supported. Firefox support is tracked in [#59](https://github.com/yifeikong/curl_cffi/issues/59).
 
 Browser versions will be added **only** when their fingerprints change. If you see a version, e.g.
 chrome122, were skipped, you can simply impersonate it with your own headers and the previous version.
 
+If you are trying to impersonate a target other than a browser, use `ja3=...` and `akamai=...`
+to specify your own customized fingerprints.
+
 - chrome99
 - chrome100
 - chrome101