Naar inhoud springen
Zo gebruik je de Fingerprint API

Genereer een fingerprint, injecteer hem, val niet op.

Vraag via een eenvoudige REST-call een consistente, realistische browserfingerprint aan en pas de velden toe op Playwright, Puppeteer of Selenium, zodat je automatisering zich voordoet als één plausibele, consistente machine.

1. Aan de slag

Haal een API-sleutel op in je dashboard en vraag daarna een fingerprint aan. /generate synthetiseert een nieuwe, unieke identiteit; /random levert een echte uit de pool.

generate.sh
# 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"
  • Filter met tags (Windows, macOS, Linux, Android, iOS) en country (ISO alpha-2).
  • format=chromium levert velden die klaar zijn voor injectie; format=raw levert de volledige gegevens.
  • Het quotum wordt alleen afgeschreven bij een geslaagde generatie.

2. Pas hem toe in je automatisering

Stel de velden op machineniveau (userAgent, viewport, locale, tijdzone) in op de browser en stem daarna de voor JS zichtbare navigator af op dezelfde machine, voordat er een paginascript draait.

playwright.py
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()

Fingerprints voor Firefox en Safari werken op dezelfde manier. De capabilityvelden die op Chromium aanwezig zijn (deviceMemory, hardwareConcurrency, client hints) worden weggelaten waar een echte browser ze niet zou blootgeven.

3. Antwoordformaten

chromium klaar voor injectie

Precies de velden die je op de browser instelt: userAgent, screen, intl, navigator, webgl. Gebruik het voor de voorbeelden hierboven.

raw volledige gegevens

De volledige fingerprintpayload (canvas, fonts, visitor_id, webgl_properties) voor opslag of je eigen injector.

4. Houd het consistent

Een fingerprint is één plausibele echte machine, geen verzameling willekeurige velden. Twee regels houden hem geloofwaardig:

Pas velden samen toe

Stel userAgent, client hints en navigator in vanuit hetzelfde antwoord. De UA overschrijven terwijl de client hints de oorspronkelijke browser melden, is het grootste verraadpunt van automatisering.

Eén fingerprint per identiteit

Gebruik dezelfde fingerprint voor een bepaald profiel/een bepaalde sessie. Velden roteren midden in een sessie lijkt op een machine die van hardware is gewisseld.

Stem de geografie van je proxy af

Combineer het land dat je aanvraagt met een egress-IP in dat land, zodat tijdzone, taal en IP overeenkomen.

5. Veelgestelde vragen

random of generate: welk endpoint?›

/fingerprint/random levert een echt, eerder verzameld apparaat uit de pool (goedkoop). /fingerprint/generate synthetiseert een nieuw, uniek apparaat onder strikte consistentie-eisen (quotum wordt alleen bij succes afgeschreven). Gebruik generate als je een unieke identiteit nodig hebt.

chromium- of raw-formaat?›

chromium is klaar voor injectie: precies de velden die je op de browser instelt (userAgent, screen, intl, navigator). raw levert de volledige fingerprintgegevens (canvas, fonts, visitor_id, webgl_properties) voor opslag of je eigen injector.

Moet ik ook de Sec-CH-UA-headers instellen?›

De fingerprint wordt afgeleid als één machine, dus de userAgent, client-hintheaders en navigator komen overeen. Het grootste verraadpunt is de UA overschrijven terwijl de client hints nog de oorspronkelijke browser melden, dus pas de velden samen toe en bewerk er niet één los met de hand.

Hoe richt ik me op een land of besturingssysteem?›

Geef country mee (ISO alpha-2, bepaalt talen + tijdzone + stemmen) en tags (Windows, macOS, Linux, Android, iOS). Zie de parametertabel op de pagina van de Fingerprint API.

Klaar om te beginnen?

Vraag een API-sleutel aan en genereer je eerste consistente fingerprint.

Haal je API-sleutel op