Saltar al contenido

Fingerprint API de Capzy. Crea una identidad coherente.

Genera una huella de navegador en JSON. Elige el sistema operativo y el país, reutiliza una identidad y aplica los campos compatibles con tu navegador.

Una identidad, señales relacionadasEjemplo ilustrativo
ID establecustomer-123
Familia de dispositivoWindows · Chromium · 1920 × 1080
Locale + zona horariaen-US / America/New_York
Grupos de salidaUser agent, pantalla, navigator, gráficos y más

Genera un perfil y aplica su configuración

Empieza con una solicitud de fingerprint. Usa los campos de respuesta que admita tu framework de automatización; descargar el JSON no aplica automáticamente todas las señales del navegador.

generate_fingerprint.py
# Install: pip install requests
import os
import requests

response = requests.get(
    "https://api.capzy.ai/fingerprint/generate",
    params={
        "key": os.environ["CAPZY_API_KEY"],
        "format": "chromium",
        "tags": "Windows",
        "country": "us",
        "id": "customer-123",  # reuse with the same options
    }, timeout=30,
)
response.raise_for_status()
fp = response.json()
if fp.get("errorId"):
    raise RuntimeError(fp)
print(fp["userAgent"]["userAgent"])
  1. Activa la API y copia tu key

    Elige un plan activo de Fingerprint API y usa una API key de Capzy de tu cuenta. Guárdala como CAPZY_API_KEY.

    Abrir Fingerprint API
  2. Elige las restricciones de identidad

    Envía format=chromium, un tag de SO y un código de país. Reutiliza id, uuid o seed con las mismas opciones para regenerar una identidad.

  3. Aplica los campos compatibles a tu navegador

    El ejemplo de Playwright aplica user agent, locale, zona horaria y viewport. Canvas, WebGL y otras señales necesitan compatibilidad específica del navegador; consulta la guía completa.

Elige el perfil que necesitas

La key es obligatoria. Las opciones de identidad y filtrado son opcionales; mantenlas coherentes al regenerar un perfil.

keyObligatorio · API key
Tu API key de Capzy. Mantenla en el servidor y fuera del JavaScript del navegador, de los repositorios públicos y de las URLs de solicitud registradas.
id / uuid / seedOpcional · identidad
Selectores de identidad alternativos. Proporciona un valor estable y reutiliza la misma configuración de filtros para una generación determinista. Omítelos para una identidad nueva.
formatPredeterminado · chromium
Elige chromium para la estructura JSON orientada al navegador que usan estos ejemplos, o raw para la representación del perfil sin procesar.
tagsOpcional · SO
Filtra la familia de dispositivo, por ejemplo Windows, macOS o Linux. Mantén el SO solicitado coherente con el navegador que usas.
countryOpcional · código de dos letras
Define el locale y las indicaciones de perfil regional. El país del fingerprint no es un proxy; configura la salida del navegador por separado cuando importe la ubicación de la IP.
min_browser_version / browser_versionOpcional · restricciones de versión
Filtra versiones con la referencia completa de la API. build_version y force_browser_version ofrecen controles adicionales; usa valores que admita tu integración de navegador.

Lee la huella por grupos

Una respuesta abreviada e ilustrativa. La respuesta de tu API contiene el fingerprint completo y puede variar según el dispositivo y el formato.

El ejemplo de Playwright aplica user agent, locale, zona horaria y viewport. Canvas, WebGL y otras señales necesitan compatibilidad específica del navegador; consulta la guía completa.
fingerprint.example.json
{
  "id": "customer-123",
  "country": "us",
  "userAgent": {
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...",
    "platform": "Win32"
  },
  "screen": {
    "innerWidth": 1903,
    "innerHeight": 927,
    "deviceScaleFactor": 1
  },
  "intl": {
    "languages": [
      "en-US",
      "en"
    ],
    "timeZone": "America/New_York"
  },
  "navigator": {
    "hardwareConcurrency": 8,
    "deviceMemory": 8
  }
}

Elige un país

Países compatibles (47)

Pasa country (ISO 3166-1 alpha-2). El idioma, Accept-Language la zona horaria, las voces de habla y las fuentes del idioma se ajustan para que coincidan.

usUnited StatesEnglish
gbUnited KingdomEnglish
caCanadaEnglish / French
auAustraliaEnglish
nzNew ZealandEnglish
ieIrelandEnglish
deGermanyGerman
frFranceFrench
esSpainSpanish
itItalyItalian
nlNetherlandsDutch
beBelgiumDutch / French
chSwitzerlandGerman / French
atAustriaGerman
seSwedenSwedish
noNorwayNorwegian
dkDenmarkDanish
fiFinlandFinnish
plPolandPolish
ptPortugalPortuguese
grGreeceGreek
czCzechiaCzech
roRomaniaRomanian
uaUkraineUkrainian
ruRussiaRussian
trTürkiyeTurkish
brBrazilPortuguese
mxMexicoSpanish
arArgentinaSpanish
clChileSpanish
coColombiaSpanish
jpJapanJapanese
krSouth KoreaKorean
cnChinaChinese (Simplified)
twTaiwanChinese (Traditional)
hkHong KongChinese
sgSingaporeEnglish
inIndiaEnglish / Hindi
idIndonesiaIndonesian
thThailandThai
vnVietnamVietnamese
phPhilippinesEnglish / Filipino
myMalaysiaMalay
zaSouth AfricaEnglish
saSaudi ArabiaArabic
aeUnited Arab EmiratesArabic
ilIsraelHebrew

Mostrando todos (47), desplázate o busca

Precios

Los planes mensuales y límites de solicitudes actuales se cargan del catálogo público. Confirma tu cupo activo en el panel.

Cargando precios actuales…

Lo que conviene saber

¿El JSON cambia mi navegador automáticamente?

No. Tu integración debe aplicar cada ajuste compatible. Las opciones de contexto de Playwright cubren algunos campos, mientras que las señales más profundas necesitan un navegador o una integración diseñados para usarlas.

¿El país del fingerprint es lo mismo que el país del proxy?

No. Los ajustes del fingerprint controlan las señales de dispositivo y de locale. Un proxy controla la salida de red. Mantenlos alineados cuando tu flujo necesite una identidad regional coherente.

¿Y si alcanzo un límite de tasa?

Revisa el cupo de solicitudes por minuto de tu plan activo y los límites de la organización. Pon las solicitudes en cola o reduce su ritmo en lugar de reintentar repetidamente a la misma velocidad.

Crea una sesión coherente desde el principio.

Genera un perfil, inspecciona sus campos y aplícalos con la guía de integración.

Abrir panel