Перейти к содержимому
Как пользоваться Fingerprint API

Сгенерируйте отпечаток, внедрите его, сливайтесь с толпой.

Запросите согласованный реалистичный отпечаток браузера простым REST-вызовом и примените его поля в Playwright, Puppeteer или Selenium, чтобы ваша автоматизация выглядела как одна правдоподобная согласованная машина.

1. Начало работы

Получите API-ключ в панели управления, затем запросите отпечаток. /generate синтезирует новую уникальную идентичность; /random возвращает реальную из пула.

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"
  • Фильтруйте по tags (Windows, macOS, Linux, Android, iOS) и country (ISO alpha-2).
  • format=chromium возвращает поля, готовые к внедрению; format=raw возвращает полные данные.
  • Квота списывается только при успешной генерации.

2. Применение в автоматизации

Задайте браузеру поля уровня машины (userAgent, viewport, locale, timezone), затем приведите видимый из JS navigator в соответствие с той же машиной до выполнения любого скрипта страницы.

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

Отпечатки Firefox и Safari работают так же. Поля возможностей, которые есть в Chromium (deviceMemory, hardwareConcurrency, client hints), опускаются там, где настоящий браузер их не раскрывает.

3. Форматы ответа

chromium готов к внедрению

Ровно те поля, которые вы задаёте браузеру: userAgent, screen, intl, navigator, webgl. Используйте его для примеров выше.

raw полные данные

Полные данные отпечатка (canvas, fonts, visitor_id, webgl_properties) для хранения или собственного инжектора.

4. Сохраняйте согласованность

Отпечаток: это одна правдоподобная реальная машина, а не набор случайных полей. Два правила делают его убедительным:

Применяйте поля вместе

Задавайте userAgent, client hints и navigator из одного ответа. Подмена UA при client hints, сообщающих исходный браузер: главный признак автоматизации.

Один отпечаток на идентичность

Используйте один и тот же отпечаток для конкретного профиля или сессии. Смена полей посреди сессии выглядит так, будто машина сменила железо.

Совпадение с географией прокси

Сочетайте запрошенную страну с исходящим IP из этой же страны, чтобы часовой пояс, язык и IP совпадали.

5. FAQ

random или generate: какой эндпоинт выбрать?›

/fingerprint/random возвращает реальное, ранее собранное устройство из пула (дёшево). /fingerprint/generate синтезирует новое уникальное устройство со строгими ограничениями согласованности (квота списывается только при успехе). Используйте generate, когда нужна уникальная идентичность.

Формат chromium или raw?›

chromium готов к внедрению: это ровно те поля, которые вы задаёте браузеру (userAgent, screen, intl, navigator). raw возвращает полные данные отпечатка (canvas, fonts, visitor_id, webgl_properties) для хранения или собственного инжектора.

Нужно ли задавать и заголовки Sec-CH-UA?›

Отпечаток формируется как одна машина, поэтому userAgent, заголовки client hints и navigator согласованы между собой. Признак №1: подменить UA, но оставить client hints, сообщающие исходный браузер. Поэтому применяйте поля вместе и не редактируйте одно отдельно от остальных.

Как выбрать страну или ОС?›

Передайте country (ISO alpha-2, определяет языки, часовой пояс и голоса) и tags (Windows, macOS, Linux, Android, iOS). Таблица параметров есть на странице Fingerprint API.

Готовы начать?

Получите API-ключ и сгенерируйте первый согласованный отпечаток.

Получить API-ключ