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.
customer-123en-US / America/New_YorkGenera 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.
# 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"])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 APIElige 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.
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.
{
"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.
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.
