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 열기신원 제약 조건 선택
format=chromium, OS 태그, 국가 코드를 보내세요. 같은 옵션으로 id, uuid 또는 seed를 재사용하면 신원을 다시 생성할 수 있습니다.
지원되는 필드를 브라우저에 적용
Playwright 예제는 user agent, 로캘, 시간대, 뷰포트를 적용합니다. Canvas, WebGL 및 기타 신호는 브라우저별 지원이 필요합니다. 전체 가이드를 참고하세요.
필요한 프로필 선택
key는 필수입니다. 신원 및 필터링 옵션은 선택 사항이며, 프로필을 다시 생성할 때는 일관되게 유지하세요.
key필수 · API 키- Capzy API 키입니다. 서버에 보관하고 브라우저 JavaScript, 공개 저장소, 기록되는 요청 URL에 노출하지 마세요.
id / uuid / seed선택 · 신원- 대체 가능한 신원 선택자입니다. 고정된 값 하나를 지정하고 같은 필터 구성을 재사용하면 결정적으로 생성됩니다. 생략하면 새 신원이 생성됩니다.
format기본값 · chromium- 이 예제에서 사용하는 브라우저 지향 JSON 구조는 chromium을, 원시 프로필 표현은 raw를 선택하세요.
tags선택 · OS- 기기 계열을 필터링합니다(예: Windows, macOS, Linux). 요청한 OS를 사용하는 브라우저와 일치시키세요.
country선택 · 두 글자 코드- 로캘과 지역 프로필 힌트를 설정합니다. 핑거프린트 국가는 프록시가 아닙니다. 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의 컨텍스트 옵션은 일부 필드를 처리하며, 더 깊은 신호는 이를 사용하도록 설계된 브라우저나 연동이 필요합니다.
핑거프린트 국가와 프록시 국가는 같은 것인가요?
아니요. 핑거프린트 설정은 기기 및 로캘 신호를 제어하고, 프록시는 네트워크 이그레스를 제어합니다. 워크플로에 일관된 지역 신원이 필요하다면 둘을 맞추세요.
속도 제한에 걸리면 어떻게 하나요?
활성 요금제의 분당 요청 허용량과 조직 한도를 확인하세요. 같은 속도로 반복 재시도하지 말고 요청을 대기열에 넣거나 속도를 줄이세요.
처음부터 일관된 세션을 구축하세요.
프로필 하나를 생성하고 필드를 살펴본 다음 연동 가이드에 따라 적용하세요.
