跳到主要内容

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 套餐,并使用你账户中的 Capzy API 密钥。将其保存为 CAPZY_API_KEY。

    打开 Fingerprint API
  2. 选择身份约束条件

    发送 format=chromium、一个操作系统标签和一个国家代码。使用相同的选项复用 id、uuid 或 seed,即可重新生成同一身份。

  3. 将支持的字段应用到你的浏览器

    Playwright 示例应用了 user agent、locale、timezone 和 viewport。Canvas、WebGL 等其他信号需要特定浏览器的支持;请参阅完整指南。

选择需要的指纹配置

key 为必填项。身份和筛选选项为可选项;重新生成配置时请保持一致。

key必填 · API 密钥
你的 Capzy API 密钥。请将其保存在服务器端,切勿放在浏览器 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、locale、timezone 和 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 的上下文选项可以覆盖部分字段,更深层的信号则需要专门设计来使用它们的浏览器或集成。

指纹的国家/地区与代理的国家/地区相同吗?

不同。指纹设置控制设备和区域信号,代理控制网络出口。当你的工作流需要一致的地区身份时,请让两者保持一致。

如果达到速率限制怎么办?

检查你当前套餐的每分钟请求额度以及组织限制。请对请求进行排队或放慢速度,而不是以相同速率反复重试。

从一开始就建立一致的会话。

生成一个配置、检查字段,并按集成指南应用。

打开控制台