Перейти к содержимому

Capzy Fingerprint API. Создайте согласованную идентичность.

Генерируйте отпечаток браузера в формате JSON. Выберите ОС и страну, используйте ту же идентичность при возвращении сессии и переносите результат в поддерживаемые настройки браузера.

Одна идентичность, связанные сигналыИллюстративный пример
Стабильный IDcustomer-123
Семейство устройствWindows · Chromium · 1920 × 1080
Локаль + часовой поясen-US / America/New_York
Группы данныхUser agent, экран, navigator, графика и многое другое

Сгенерируйте профиль, затем примените его настройки

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

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. Активируйте API и скопируйте ключ

    Выберите активный тариф Fingerprint API и используйте API-ключ Capzy из своего аккаунта. Храните его как CAPZY_API_KEY.

    Открыть Fingerprint API
  2. Выберите ограничения идентичности

    Отправьте format=chromium, тег ОС и код страны. Используйте тот же id, uuid или seed с теми же параметрами, чтобы воссоздать идентичность.

  3. Примените поддерживаемые поля в браузере

    Пример на Playwright применяет user agent, локаль, часовой пояс и viewport. Для canvas, WebGL и других сигналов нужна поддержка на уровне конкретного браузера; см. полное руководство.

Выберите нужный профиль

Ключ обязателен. Параметры идентичности и фильтрации необязательны; при повторной генерации профиля сохраняйте их неизменными.

keyОбязательно · API-ключ
Ваш API-ключ Capzy. Храните его на сервере, а не в JavaScript браузера, публичных репозиториях или логируемых URL запросов.
id / uuid / seedНеобязательно · идентичность
Альтернативные селекторы идентичности. Передайте одно стабильное значение и используйте ту же конфигурацию фильтров для детерминированной генерации. Не указывайте их, чтобы получить новую идентичность.
formatПо умолчанию · chromium
Выберите chromium для JSON-структуры, ориентированной на браузер (используется в этих примерах), или raw для сырого представления профиля.
tagsНеобязательно · ОС
Фильтр семейства устройств, например Windows, macOS или Linux. Запрошенная ОС должна соответствовать используемому браузеру.
countryНеобязательно · двухбуквенный код
Задаёт локаль и региональные подсказки профиля. Страна отпечатка: это не прокси; настраивайте исходящий трафик браузера отдельно, если важно местоположение IP.
min_browser_version / browser_versionНеобязательно · ограничения версии
Фильтруйте версии с помощью полного справочника API. build_version и force_browser_version дают дополнительный контроль; используйте значения, которые поддерживает ваша интеграция с браузером.

Читайте отпечаток по группам

Сокращённый иллюстративный ответ. Реальный ответ API содержит полный отпечаток и может отличаться в зависимости от устройства и формата.

Пример на Playwright применяет user agent, локаль, часовой пояс и viewport. Для canvas, WebGL и других сигналов нужна поддержка на уровне конкретного браузера; см. полное руководство.
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
  }
}

Выберите страну

Поддерживаемые страны (47)

Передайте country (ISO 3166-1 alpha-2). Язык, Accept-Language, часовой пояс, голоса синтеза речи и шрифты локали настраиваются соответственно.

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

Показаны все 47, прокрутите или воспользуйтесь поиском

Цены

Актуальные ежемесячные тарифы и лимиты запросов загружаются из публичного каталога. Проверьте активный лимит в панели управления.

Загрузка актуальных цен…

Что нужно знать

JSON меняет мой браузер автоматически?

Нет. Ваша интеграция должна применить каждую поддерживаемую настройку. Опции контекста Playwright охватывают часть полей, а для более глубоких сигналов нужен браузер или интеграция, умеющие их использовать.

Страна отпечатка совпадает со страной прокси?

Нет. Настройки отпечатка управляют сигналами устройства и локали. Прокси управляет исходящим сетевым трафиком. Согласуйте их, если вашему процессу нужна последовательная региональная идентичность.

Что делать, если достигнут лимит запросов?

Проверьте лимит запросов в минуту для активного тарифа и ограничения организации. Ставьте запросы в очередь или замедляйте их вместо повторных попыток с той же частотой.

Стройте согласованную сессию с самого начала.

Сгенерируйте один профиль, изучите его поля и примените их по руководству по интеграции.

Открыть панель управления