Générez une empreinte, injectez-la, fondez-vous dans la masse.
Demandez une empreinte de navigateur cohérente et réaliste via un simple appel REST, puis appliquez ses champs à Playwright, Puppeteer ou Selenium pour que votre automatisation se présente comme une seule machine plausible et cohérente.
1. Prise en main
Récupérez une clé API dans votre tableau de bord, puis demandez une empreinte. /generate synthétise une identité nouvelle et unique ; /random en renvoie une réelle issue du pool.
# Generate a fresh, coherent fingerprint (quota deducts on success)
curl "https://api.capzy.ai/fingerprint/generate?key=YOUR_API_KEY&format=chromium&tags=Windows&country=us"- Filtrez avec tags (Windows, macOS, Linux, Android, iOS) et country (ISO alpha-2).
- format=chromium renvoie des champs prêts à injecter ; format=raw renvoie les données complètes.
- Le quota n’est déduit qu’en cas de génération réussie.
2. Appliquez-la à votre automatisation
Définissez les champs au niveau de la machine (userAgent, viewport, locale, timezone) sur le navigateur, puis alignez le navigator visible en JS sur la même machine avant l’exécution de tout script de la page.
import requests
from playwright.sync_api import sync_playwright
# 1. Generate a coherent fingerprint for a Windows visitor in the US
fp = requests.get("https://api.capzy.ai/fingerprint/generate", params={
"key": "YOUR_API_KEY",
"format": "chromium", # injection-ready
"tags": "Windows",
"country": "us",
}).json()
rect = fp["screen"]["screenRect"]
with sync_playwright() as p:
browser = p.chromium.launch()
# 2. Apply the machine-level fields on the context
context = browser.new_context(
user_agent=fp["userAgent"]["userAgent"],
locale=fp["intl"]["languages"][0],
timezone_id=fp["intl"]["timeZone"],
viewport={"width": rect["width"], "height": rect["height"]},
device_scale_factor=fp["screen"]["deviceScaleFactor"],
)
# 3. Match the JS-visible navigator to the SAME machine (before page scripts)
context.add_init_script(f"""
Object.defineProperty(navigator, 'hardwareConcurrency', {{ get: () => {fp['navigator']['hardwareConcurrency']} }});
Object.defineProperty(navigator, 'deviceMemory', {{ get: () => {fp['navigator']['deviceMemory']} }});
Object.defineProperty(navigator, 'platform', {{ get: () => '{fp['userAgent']['platform']}' }});
""")
page = context.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()Les empreintes Firefox et Safari fonctionnent de la même manière. Les champs de capacités présents sur Chromium (deviceMemory, hardwareConcurrency, client hints) sont omis là où un vrai navigateur ne les exposerait pas.
3. Formats de réponse
chromium prêt à injecter
Exactement les champs à définir sur le navigateur : userAgent, screen, intl, navigator, webgl. Utilisez-le pour les exemples ci-dessus.
raw données complètes
Le payload complet de l’empreinte (canvas, fonts, visitor_id, webgl_properties) pour le stockage ou votre propre injecteur.
4. Restez cohérent
Une empreinte correspond à une seule machine réelle et plausible, pas à un assortiment de champs aléatoires. Deux règles la rendent crédible :
Définissez userAgent, client hints et navigator à partir de la même réponse. Remplacer l’UA alors que les client hints indiquent le navigateur d’origine est le signal d’automatisation numéro un.
Réutilisez la même empreinte pour un profil ou une session donnés. Changer des champs en cours de session donne l’impression d’une machine qui a changé de matériel.
Associez le pays demandé à une IP de sortie dans ce même pays pour que le fuseau horaire, la langue et l’IP concordent.
5. FAQ
random ou generate : quel endpoint ?›
/fingerprint/random renvoie un appareil réel, collecté au préalable dans le pool (peu coûteux). /fingerprint/generate en synthétise un nouveau et unique sous de strictes contraintes de cohérence (quota déduit uniquement en cas de réussite). Utilisez generate quand vous avez besoin d’une identité unique.
Format chromium ou raw ?›
chromium est prêt à injecter : exactement les champs à définir sur le navigateur (userAgent, screen, intl, navigator). raw renvoie toutes les données de l’empreinte (canvas, fonts, visitor_id, webgl_properties) pour les stocker ou les utiliser avec votre propre injecteur.
Dois-je aussi définir les en-têtes Sec-CH-UA ?›
L’empreinte est dérivée comme une seule machine : le userAgent, les en-têtes client hints et navigator concordent. Le signal n°1 consiste à remplacer l’UA en laissant les client hints indiquer le navigateur d’origine : appliquez donc les champs ensemble et n’en modifiez pas un isolément.
Comment cibler un pays ou un OS ?›
Passez country (ISO alpha-2, détermine les langues, le fuseau horaire et les voix) et tags (Windows, macOS, Linux, Android, iOS). Consultez le tableau des paramètres sur la page Fingerprint API.
Prêt à commencer ?
Obtenez une clé API et générez votre première empreinte cohérente.