Saltar al contenido
Cómo usar Fingerprint API

Genera un fingerprint, inyéctalo y pasa desapercibido.

Solicita un fingerprint de navegador coherente y real con una simple llamada REST y luego aplica sus campos a Playwright, Puppeteer o Selenium para que tu automatización se presente como una única máquina plausible y coherente.

1. Primeros pasos

Consigue una API key en tu panel y solicita un fingerprint. /generate sintetiza una identidad nueva y única; /random devuelve una real del 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"
  • Filtra con tags (Windows, macOS, Linux, Android, iOS) y country (ISO alpha-2).
  • format=chromium devuelve campos listos para inyectar; format=raw devuelve los datos completos.
  • La cuota solo se descuenta cuando la generación tiene éxito.

2. Aplícalo en tu automatización

Define los campos a nivel de máquina (userAgent, viewport, locale, timezone) en el navegador y haz que el navigator visible desde JS coincida con la misma máquina antes de que se ejecute cualquier script de la página.

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()

Los fingerprints de Firefox y Safari funcionan igual. Los campos de capacidades presentes en Chromium (deviceMemory, hardwareConcurrency, client hints) se omiten donde un navegador real no los expondría.

3. Formatos de respuesta

chromium listo para inyectar

Los campos exactos que defines en el navegador: userAgent, screen, intl, navigator, webgl. Úsalo en los ejemplos de arriba.

raw datos completos

El payload completo del fingerprint (canvas, fonts, visitor_id, webgl_properties) para almacenarlo o usarlo en tu propio inyector.

4. Mantenlo coherente

Un fingerprint es una máquina real plausible, no un conjunto de campos aleatorios. Dos reglas lo mantienen creíble:

Aplica los campos juntos

Define userAgent, client hints y navigator a partir de la misma respuesta. Sobrescribir el UA mientras los client hints informan del navegador original es la señal de automatización número uno.

Un fingerprint por identidad

Reutiliza el mismo fingerprint para un perfil/sesión determinado. Rotar campos a mitad de sesión parece una máquina que cambió de hardware.

Haz coincidir la geografía del proxy

Combina el país que solicitas con una IP de salida de ese país para que la zona horaria, el idioma y la IP coincidan.

5. Preguntas frecuentes

random o generate: ¿qué endpoint?›

/fingerprint/random devuelve un dispositivo real recopilado previamente del pool (económico). /fingerprint/generate sintetiza uno nuevo y único con estrictas restricciones de coherencia (la cuota solo se descuenta si tiene éxito). Usa generate cuando necesites una identidad única.

¿Formato chromium o raw?›

chromium está listo para inyectar: los campos exactos que defines en el navegador (userAgent, screen, intl, navigator). raw devuelve los datos completos del fingerprint (canvas, fonts, visitor_id, webgl_properties) para almacenarlos o usarlos en tu propio inyector.

¿También tengo que definir los headers Sec-CH-UA?›

El fingerprint se deriva como una sola máquina, así que el userAgent, los headers de client hints y navigator coinciden. La señal delatora número 1 es sobrescribir el UA pero dejar que los client hints sigan informando del navegador original, así que aplica los campos juntos y no edites uno a mano por separado.

¿Cómo me dirijo a un país o SO concreto?›

Pasa country (ISO alpha-2, determina idiomas + zona horaria + voces) y tags (Windows, macOS, Linux, Android, iOS). Consulta la tabla de parámetros en la página de Fingerprint API.

¿Listo para empezar?

Obtén una API key y genera tu primer fingerprint coherente.

Obtén tu API key