Zum Inhalt springen
So nutzt du die Fingerprint API

Fingerprint erzeugen, injizieren, unauffällig bleiben.

Fordere über einen einfachen REST-Aufruf einen kohärenten, realen Browser-Fingerprint an und wende seine Felder auf Playwright, Puppeteer oder Selenium an, damit deine Automatisierung eine plausible, konsistente Maschine meldet.

1. Erste Schritte

Hol dir einen API-Schlüssel aus deinem Dashboard und fordere dann einen Fingerprint an. /generate erzeugt eine frische, einzigartige Identität; /random liefert eine echte aus dem 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"
  • Filtere mit tags (Windows, macOS, Linux, Android, iOS) und country (ISO alpha-2).
  • format=chromium liefert injektionsbereite Felder; format=raw liefert die vollständigen Daten.
  • Das Kontingent wird nur bei einer erfolgreichen Generierung abgezogen.

2. In deiner Automatisierung anwenden

Setze die Felder auf Maschinenebene (userAgent, viewport, locale, timezone) im Browser und gleiche dann den per JS sichtbaren navigator an dieselbe Maschine an, bevor ein Seitenskript läuft.

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 für Firefox und Safari funktionieren genauso. Die Fähigkeitsfelder von Chromium (deviceMemory, hardwareConcurrency, Client Hints) werden weggelassen, wo ein echter Browser sie nicht offenlegen würde.

3. Antwortformate

chromium injektionsbereit

Genau die Felder, die du im Browser setzt: userAgent, screen, intl, navigator, webgl. Verwende es für die Beispiele oben.

raw vollständige Daten

Die vollständige Fingerprint-Payload (canvas, fonts, visitor_id, webgl_properties) zum Speichern oder für deinen eigenen Injector.

4. Kohärent bleiben

Ein Fingerprint ist eine plausible echte Maschine, keine Sammlung zufälliger Felder. Zwei Regeln halten ihn glaubwürdig:

Felder gemeinsam anwenden

Setze userAgent, Client Hints und navigator aus derselben Antwort. Einen UA zu überschreiben, während die Client Hints den ursprünglichen Browser melden, ist das Erkennungsmerkmal Nummer eins für Automatisierung.

Ein Fingerprint pro Identität

Verwende für ein bestimmtes Profil bzw. eine Sitzung immer denselben Fingerprint. Felder mitten in der Sitzung zu rotieren, wirkt wie eine Maschine, die ihre Hardware gewechselt hat.

Proxy-Standort abgleichen

Kombiniere das angefragte Land mit einer Ausgangs-IP in diesem Land, damit Zeitzone, Sprache und IP übereinstimmen.

5. FAQ

random oder generate: welcher Endpunkt?›

/fingerprint/random liefert ein echtes, zuvor gesammeltes Gerät aus dem Pool (günstig). /fingerprint/generate erzeugt ein frisches, einzigartiges Gerät unter strengen Konsistenzregeln (Kontingent wird nur bei Erfolg abgezogen). Verwende generate, wenn du eine einzigartige Identität brauchst.

Format chromium oder raw?›

chromium ist injektionsbereit: genau die Felder, die du im Browser setzt (userAgent, screen, intl, navigator). raw liefert die vollständigen Fingerprint-Daten (canvas, fonts, visitor_id, webgl_properties) zum Speichern oder für deinen eigenen Injector.

Muss ich auch die Sec-CH-UA-Header setzen?›

Der Fingerprint wird als eine einzige Maschine abgeleitet, daher stimmen userAgent, Client-Hint-Header und navigator überein. Das häufigste Erkennungsmerkmal ist ein überschriebener UA, während die Client Hints noch den ursprünglichen Browser melden. Wende die Felder also gemeinsam an und bearbeite keines isoliert von Hand.

Wie ziele ich auf ein Land oder Betriebssystem?›

Übergib country (ISO alpha-2, steuert Sprachen + Zeitzone + Stimmen) und tags (Windows, macOS, Linux, Android, iOS). Siehe die Parametertabelle auf der Fingerprint API-Seite.

Bereit loszulegen?

Hol dir einen API-Schlüssel und erzeuge deinen ersten kohärenten Fingerprint.

API-Schlüssel holen