Fingerprint API

Authentication

All endpoints require an API key.

Supported parameters:

• key
• clientKey

Example:

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

If the key is missing or invalid, the API returns an authentication error.

You can manage your key in your account settings

Response formats

The format parameter controls the response structure:

• chromium — normalized format for Chromium-based clients (default)
• raw — low-level format for legacy client compatibility

If omitted, chromium is used.

API methods

Quick links:

• /fingerprint/random — random fingerprint
• /fingerprint/generate — generate by parameters

GET /fingerprint/random

Returns a random browser fingerprint from our database, applying your filters.

This method is billable. Your quota is only deducted when a fingerprint is successfully returned.

Request parameters:

Example requests:

# With tags and country
GET https://api.2captcha.com/fingerprint/random?key=USER_KEY&format=chromium&tags=Windows&country=us

# With minimum browser version
GET https://api.2captcha.com/fingerprint/random?key=USER_KEY&format=chromium&tags=Windows&min_browser_version=144

Example chromium response:

{
  "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
      }
    ]
  }
}

Example raw response:

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

GET /fingerprint/generate

Generates a new fingerprint based on your specified parameters.

This method is billable. Your quota is only deducted upon successful generation.

Request parameters:

Example request:

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

Example chromium response:

{
  "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" }
}

Example raw response:

{
  "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)"
  }
}

Limits

Access to the Fingerprint API depends on your active subscription.

Two main limits apply:

• max_requests_minute — limit on successful billable requests per minute
• max_rps — protective limit on requests per second

If max_requests_minute = 0, there is no strict per-minute cap. Even unlimited plans may enforce max_rps to guard against traffic spikes.

Available plans

All plans support both response formats: chromium and raw. The Fingerprint Unlimited plan includes an optional proxy data package.

How quota deduction works

Quota is only deducted on successful responses for billable methods. If the data source is unavailable or the request is invalid, your quota stays intact.

Changing your plan

Want to upgrade right now?

You can switch anytime. Just log into your account, pick your new plan, and activate it. Changes take effect immediately, and you get instant access to the new limits. We do not prorate unused days on your current plan.

Prefer to wait until your current subscription ends?

Automatic switching at period end is not supported. Once your subscription expires, simply purchase your desired plan manually in your account settings.

Want to downgrade to a cheaper plan?

Wait for your current billing period to end, then activate the new plan. This way, you do not lose any prepaid days.

To subscribe or change your plan:

• Go to your account settings
• Or contact our sales team for help choosing the right option

Error handling

All errors use the ERROR_ prefix.

Example error response:

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

Notes

• For the raw format, we recommend using the min_browser_version parameter.
• If you provide browser_version or force_browser_version without setting min_browser_version, the API may treat them as a minimum version constraint.
• The include_proxy parameter is only supported with format=chromium.

Reference

Available tags

The tags parameter accepts one or more values from this list:

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

Usage examples:

• tags=Windows — fingerprints for Windows devices
• tags=Android&tags=Mobile — Android mobile devices
• tags=Chrome&tags=Desktop — desktop Chrome browser

Available countries

The country parameter uses two-letter country codes following the ISO 3166-1 alpha-2 standard.

Examples: us, de, ru, fr, gb, ca, au

Find the full list of codes here.