Fingerprint API

Авторизация

Все методы требуют API-ключ.

Поддерживаемые параметры:

• key (рекомендуемый)
• clientKey

Пример:

GET https://api.2captcha.com/fingerprint/random?key=USER_KEY&format=chromium

Если ключ не передан или неверный, API возвращает ошибку авторизации.

Настроить и посмотреть ключ можно в личном кабинете

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

Параметр format определяет структуру ответа:

• chromium — нормализованный формат для Chromium-клиентов (используется по умолчанию)
• raw — низкоуровневый формат для совместимости с legacy-клиентами

Если параметр не указан, применяется chromium.

Методы API

Навигация по методам:

• /fingerprint/random — случайный отпечаток
• /fingerprint/generate — генерация по параметрам

GET /fingerprint/random

Возвращает случайный отпечаток браузера из базы с учётом фильтров.

Метод тарифицируется. Квота списывается только при успешном получении отпечатка.

Параметры запроса:

Примеры запросов:

# С тегами и страной
GET https://api.2captcha.com/fingerprint/random?key=USER_KEY&format=chromium&tags=Windows&country=us

# С минимальной версией браузера
GET https://api.2captcha.com/fingerprint/random?key=USER_KEY&format=chromium&tags=Windows&min_browser_version=144

Пример ответа chromium:

{
  "id": "fp_123456",
  "country": "us",
  "screen": {
    "width": 1920,
    "height": 1080
  },
  "userAgent": {
    "value": "Mozilla/5.0 ..."
  },
  "navigator": {
    "platform": "Win32",
    "hardwareConcurrency": 8,
    "deviceMemory": 8
  },
  "webgl": {
    "vendor": "Google Inc.",
    "renderer": "ANGLE ..."
  },
  "speechSynthesis": {
    "voices": [
      {
        "name": "Microsoft David - English (United States)",
        "lang": "en-US",
        "isDefault": true
      }
    ]
  }
}

Пример ответа raw:

{
  "status": "success",
  "id": "fp_123456",
  "country": "us",
  "data": {
    "ua": "Mozilla/5.0 ...",
    "width": 1920,
    "height": 1080,
    "attr": {},
    "webgl_properties": {}
  }
}

GET /fingerprint/generate

Генерирует новый отпечаток по заданным параметрам.

Метод тарифицируется. Квота списывается только при успешной генерации.

Параметры запроса:

Пример запроса:

GET https://api.2captcha.com/fingerprint/generate?key=USER_KEY&format=chromium&tags=Windows&country=de

Пример ответа chromium:

{
  "id": "number",
  "screen": { "deviceScaleFactor": "number", "screenRect": "Rect" },
  "intl": { "languages": "string[]", "timeZone": "string" },
  "speechSynthesis": { "voices": "VoiceInfo[]" },
  "webgl": { "glParameters": "object", "glAvailableExtensions": "string[]" },
  "webgpu": { "highPerformance": "WebGpuInfo" },
  "userAgent": { "userAgent": "string", "platform": "string" },
  "navigator": { "hardwareConcurrency": "number", "deviceMemory": "number" }
}

Пример ответа raw:

{
  "status": "string",
  "id": "number",
  "data": {
    "valid": "boolean",
    "ua": "string",
    "tags": "array[string]",
    "canvas": "string (hash)",
    "webgl_properties": "object",
    "fonts": "array[string]",
    "visitor_id": "string (hash)"
  }
}

Лимиты

Доступ к Fingerprint API определяется активной подпиской.

Используются два основных ограничения:

• max_requests_minute — лимит успешных платных запросов в минуту
• max_rps — защитный лимит запросов в секунду

Если max_requests_minute = 0, жёсткий минутный лимит отсутствует. Даже для безлимитных тарифов может применяться max_rps для защиты от всплесков нагрузки.

Доступные тарифы

Все тарифы поддерживают оба формата ответа: chromium и raw. Тариф Fingerprint Unlimited включает опциональный пакет прокси-данных.

Как работает списание квоты

Квота списывается только при успешном ответе для тарифицируемых методов. Если источник данных недоступен или запрос не валиден, квота не расходуется.

Смена тарифа

Если хотите перейти на тариф дороже прямо сейчас:

Это можно сделать в любой момент. Зайдите в личный кабинет, выберите новый тариф и активируйте его. Изменения вступят в силу сразу, доступ к новым лимитам откроется моментально. Перерасчёт за неиспользованные дни текущего тарифа не производится.

Если хотите дождаться окончания текущей подписки:

Автоматическое переключение в конце периода не поддерживается. Когда подписка закончится, просто купите нужный тариф вручную в настройках аккаунта.

Если хотите перейти на тариф дешевле:

Дождитесь окончания текущего периода, затем активируйте новый тариф. Это поможет не потерять оплаченные дни.

Для подключения или смены тарифа:

• Зайдите в настройки аккаунта
• Или свяжитесь с отделом продаж для помощи с выбором

Обработка ошибок

Все ошибки имеют префикс ERROR_.

Пример ответа с ошибкой:

{
  "errorId": 2007,
  "errorCode": "ERROR_FINGERPRINT_RATE_LIMITED",
  "errorDescription": "Fingerprint request rate limit exceeded for the current plan."
}

Примечания

• Для формата raw рекомендуется использовать параметр min_browser_version.
• Если передан browser_version или force_browser_version, а min_browser_version не задан, API может использовать их как ограничение минимальной версии.
• Параметр include_proxy поддерживается только для format=chromium.

Справочник

Доступные теги

Параметр tags принимает одно или несколько значений из списка:

Chrome, Firefox, Edge, YaBrowser, Mobile, Desktop, Android, iOS, Microsoft Windows, Apple Mac, macOS, Linux, iPhone

Примеры использования:

• tags=Windows — отпечатки для устройств на Windows
• tags=Android&tags=Mobile — мобильные устройства на Android
• tags=Chrome&tags=Desktop — десктопный браузер Chrome

Доступные страны

Параметр country принимает двухбуквенные коды стран по стандарту ISO 3166-1 alpha-2.

Примеры: us, de, ru, fr, gb, ca, au

Полный список кодов доступен по ссылке.