コンテンツへスキップ

Capzy Fingerprint API. 一貫したIDを構築。

ブラウザフィンガープリントをJSONで生成します。OSと国を選び、セッションが戻ってきたときはIDを再利用し、出力をブラウザで対応している設定に反映します。

1つのID、関連するシグナル説明用の例
固定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. IDの条件を選ぶ

    format=chromium、OSタグ、国コードを送信します。IDを再生成するには、同じオプションでid、uuid、seedを再利用します。

  3. 対応するフィールドをブラウザに適用

    Playwrightの例では、User-Agent、ロケール、タイムゾーン、ビューポートを適用しています。canvas、WebGLなどのシグナルにはブラウザごとの対応が必要です。完全なガイドをご覧ください。

必要なプロファイルを選ぶ

keyは必須です。IDと絞り込みのオプションは任意で、プロファイルを再生成する際は同じ値を使ってください。

key必須 · APIキー
Capzy APIキー。サーバー側で管理し、ブラウザのJavaScript、公開リポジトリ、ログに残るリクエストURLには含めないでください。
id / uuid / seed任意 · ID
IDを選択するための代替パラメーターです。固定の値を1つ指定し、同じフィルター設定を再利用すると、決定的に生成されます。省略すると新しいIDになります。
formatデフォルト · chromium
これらの例で使用しているブラウザ向けのJSON構造にはchromiumを、rawのプロファイル表現にはrawを選択します。
tags任意 · OS
デバイスファミリーを絞り込みます(例:Windows、macOS、Linux)。リクエストするOSは、使用するブラウザと一致させてください。
country任意 · 2文字のコード
ロケールと地域のプロファイルのヒントを設定します。フィンガープリントの国はプロキシではありません。IPの所在地が重要な場合は、ブラウザの出口を別途設定してください。
min_browser_version / browser_version任意 · バージョンの制約
完全なAPIリファレンスに従ってバージョンを絞り込みます。build_versionとforce_browser_versionで追加の制御ができます。ブラウザとの連携が対応している値を使用してください。

フィンガープリントをグループごとに読む

説明用に短縮したレスポンスです。実際のAPIレスポンスには完全なフィンガープリントが含まれ、デバイスや形式によって異なる場合があります。

Playwrightの例では、User-Agent、ロケール、タイムゾーン、ビューポートを適用しています。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のコンテキストオプションで一部のフィールドは設定できますが、より深いシグナルには、それを扱えるように設計されたブラウザや連携が必要です。

フィンガープリントの国とプロキシの国は同じですか?

いいえ。フィンガープリントの設定はデバイスとロケールのシグナルを制御し、プロキシはネットワークの出口を制御します。ワークフローで地域的に一貫したIDが必要な場合は、両者を合わせてください。

レート制限に達した場合は?

有効なプランの1分あたりのリクエスト上限と、組織の制限を確認してください。同じペースで再試行を繰り返すのではなく、リクエストをキューに入れるか、速度を落としてください。

最初から一貫したセッションを構築。

プロファイルを1つ生成してフィールドを確認し、連携ガイドに従って適用しましょう。

ダッシュボードを開く