customer-123en-US / America/New_Yorkプロファイルを生成して、その設定を適用
まずはフィンガープリントをリクエストします。自動化フレームワークが対応しているレスポンスのフィールドを使用してください。JSONをダウンロードしても、すべてのブラウザのシグナルが自動で適用されるわけではありません。
# 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"])APIを有効にしてキーをコピー
有効なFingerprint APIプランを選び、アカウントのCapzy APIキーを使用します。CAPZY_API_KEYとして保存してください。
Fingerprint APIを開くIDの条件を選ぶ
format=chromium、OSタグ、国コードを送信します。IDを再生成するには、同じオプションでid、uuid、seedを再利用します。
対応するフィールドをブラウザに適用
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レスポンスには完全なフィンガープリントが含まれ、デバイスや形式によって異なる場合があります。
{
"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、タイムゾーン、音声合成の音声、ロケールのフォントがすべてそれに合わせて設定されます。
全47件を表示中。スクロールまたは検索してください
料金
現在の月額プランとリクエストの上限は、公開カタログから読み込まれます。有効な利用枠はダッシュボードでご確認ください。
最新の料金を読み込み中…
知っておきたいこと
JSONでブラウザが自動的に変わりますか?
いいえ。対応する各設定は、お客様の連携で適用する必要があります。Playwrightのコンテキストオプションで一部のフィールドは設定できますが、より深いシグナルには、それを扱えるように設計されたブラウザや連携が必要です。
フィンガープリントの国とプロキシの国は同じですか?
いいえ。フィンガープリントの設定はデバイスとロケールのシグナルを制御し、プロキシはネットワークの出口を制御します。ワークフローで地域的に一貫したIDが必要な場合は、両者を合わせてください。
レート制限に達した場合は?
有効なプランの1分あたりのリクエスト上限と、組織の制限を確認してください。同じペースで再試行を繰り返すのではなく、リクエストをキューに入れるか、速度を落としてください。
最初から一貫したセッションを構築。
プロファイルを1つ生成してフィールドを確認し、連携ガイドに従って適用しましょう。
