Skip to content

Crawlee—A web scraping and browser automation library for Node.js to build reliable crawlers. In JavaScript and TypeScript. Extract data for AI, LLMs, RAG, or GPTs. Download HTML, PDF, JPG, PNG, and other files from websites. Works with Puppeteer, Playwright, Cheerio, JSDOM, and raw HTTP. Both headful and headless mode. With proxy rotation.

docs: mention new `impit` fingerprints in the docs (#3400)

Jindřich Bärbfb861c296e8
diff --git a/docs/guides/impit-http-client/impit-http-client.mdx b/docs/guides/impit-http-client/impit-http-client.mdx
index 533d8dfd3..89c71e82f 100644
--- a/docs/guides/impit-http-client/impit-http-client.mdx
+++ b/docs/guides/impit-http-client/impit-http-client.mdx
@@ -68,22 +68,30 @@ The `ImpitHttpClient` constructor accepts the following options:
| Option | Type | Default | Description |
|--------|------|---------|-------------|
-| `browser` | `'chrome'` \| `'firefox'` | `undefined` | Browser to impersonate. Affects TLS fingerprint and default headers. |
+| `browser` | `'chrome'` \| `'firefox'` \| `...` | `undefined` | Browser to impersonate. Affects TLS fingerprint and default headers. |
| `http3` | `boolean` | `false` | Enable HTTP/3 (QUIC) protocol support. |
| `ignoreTlsErrors` | `boolean` | `false` | Ignore TLS certificate errors. Useful for testing or self-signed certificates. |
-### Browser impersonation
-Use the `Browser` enum to specify which browser to impersonate:
+### Available fingerprints
+
+Impit bundles several realistic browser fingerprints.
+Using version-specific fingerprints can improve success rates against sophisticated bot detection systems that track browser versions and flag outdated signatures.
+
+When using generic fingerprints (`chrome` or `firefox`), Impit automatically selects an appropriate version. For most use cases, the generic options are sufficient.
+However, if you're targeting a site with particularly strict bot detection, or need to match a specific browser environment, you can specify an exact version:
```ts
-import { ImpitHttpClient, Browser } from '@crawlee/impit-client';
+import { ImpitHttpClient } from '@crawlee/impit-client';
+
+// Use a generic Chrome fingerprint
+const chromeClient = new ImpitHttpClient({ browser: 'chrome' });
-// Impersonate Firefox
-const firefoxClient = new ImpitHttpClient({ browser: Browser.Firefox });
+// Use a specific Chrome version
+const chrome131Client = new ImpitHttpClient({ browser: 'chrome131' });
-// Impersonate Chrome
-const chromeClient = new ImpitHttpClient({ browser: Browser.Chrome });
+// Or a specific Firefox version
+const firefox144Client = new ImpitHttpClient({ browser: 'firefox144' });
```
### Advanced configuration
diff --git a/website/versioned_docs/version-3.16/guides/impit-http-client/impit-http-client.mdx b/website/versioned_docs/version-3.16/guides/impit-http-client/impit-http-client.mdx
index 533d8dfd3..89c71e82f 100644
--- a/website/versioned_docs/version-3.16/guides/impit-http-client/impit-http-client.mdx
+++ b/website/versioned_docs/version-3.16/guides/impit-http-client/impit-http-client.mdx
@@ -68,22 +68,30 @@ The `ImpitHttpClient` constructor accepts the following options:
| Option | Type | Default | Description |
|--------|------|---------|-------------|
-| `browser` | `'chrome'` \| `'firefox'` | `undefined` | Browser to impersonate. Affects TLS fingerprint and default headers. |
+| `browser` | `'chrome'` \| `'firefox'` \| `...` | `undefined` | Browser to impersonate. Affects TLS fingerprint and default headers. |
| `http3` | `boolean` | `false` | Enable HTTP/3 (QUIC) protocol support. |
| `ignoreTlsErrors` | `boolean` | `false` | Ignore TLS certificate errors. Useful for testing or self-signed certificates. |
-### Browser impersonation
-Use the `Browser` enum to specify which browser to impersonate:
+### Available fingerprints
+
+Impit bundles several realistic browser fingerprints.
+Using version-specific fingerprints can improve success rates against sophisticated bot detection systems that track browser versions and flag outdated signatures.
+
+When using generic fingerprints (`chrome` or `firefox`), Impit automatically selects an appropriate version. For most use cases, the generic options are sufficient.
+However, if you're targeting a site with particularly strict bot detection, or need to match a specific browser environment, you can specify an exact version:
```ts
-import { ImpitHttpClient, Browser } from '@crawlee/impit-client';
+import { ImpitHttpClient } from '@crawlee/impit-client';
+
+// Use a generic Chrome fingerprint
+const chromeClient = new ImpitHttpClient({ browser: 'chrome' });
-// Impersonate Firefox
-const firefoxClient = new ImpitHttpClient({ browser: Browser.Firefox });
+// Use a specific Chrome version
+const chrome131Client = new ImpitHttpClient({ browser: 'chrome131' });
-// Impersonate Chrome
-const chromeClient = new ImpitHttpClient({ browser: Browser.Chrome });
+// Or a specific Firefox version
+const firefox144Client = new ImpitHttpClient({ browser: 'firefox144' });
```
### Advanced configuration