본문으로 건너뛰기

Capzy Fingerprint API. 일관된 신원을 구축하세요.

브라우저 핑거프린트를 JSON으로 생성하세요. OS와 국가를 선택하고, 세션이 돌아올 때 신원을 재사용하며, 출력을 브라우저에서 지원하는 설정에 매핑하세요.

하나의 신원, 연관된 신호설명용 예시
고정 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, OS 태그, 국가 코드를 보내세요. 같은 옵션으로 id, uuid 또는 seed를 재사용하면 신원을 다시 생성할 수 있습니다.

  3. 지원되는 필드를 브라우저에 적용

    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 응답에는 전체 핑거프린트가 포함되며 기기와 형식에 따라 다를 수 있습니다.

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의 컨텍스트 옵션은 일부 필드를 처리하며, 더 깊은 신호는 이를 사용하도록 설계된 브라우저나 연동이 필요합니다.

핑거프린트 국가와 프록시 국가는 같은 것인가요?

아니요. 핑거프린트 설정은 기기 및 로캘 신호를 제어하고, 프록시는 네트워크 이그레스를 제어합니다. 워크플로에 일관된 지역 신원이 필요하다면 둘을 맞추세요.

속도 제한에 걸리면 어떻게 하나요?

활성 요금제의 분당 요청 허용량과 조직 한도를 확인하세요. 같은 속도로 반복 재시도하지 말고 요청을 대기열에 넣거나 속도를 줄이세요.

처음부터 일관된 세션을 구축하세요.

프로필 하나를 생성하고 필드를 살펴본 다음 연동 가이드에 따라 적용하세요.

대시보드 열기