Vai al contenuto

Capzy Fingerprint API. Costruisci un'identità coerente.

Genera un fingerprint di browser in formato JSON. Scegli un OS e un paese, riutilizza un'identità quando una sessione ritorna e mappa l'output sulle impostazioni supportate dal tuo browser.

Un'identità, segnali correlatiEsempio illustrativo
ID stabilecustomer-123
Famiglia di dispositiviWindows · Chromium · 1920 × 1080
Lingua + fuso orarioen-US / America/New_York
Gruppi di outputUser agent, schermo, navigator, grafica e altro

Genera un profilo, poi applicane le impostazioni

Inizia con una richiesta di fingerprint. Usa i campi della risposta supportati dal tuo framework di automazione; scaricare il JSON non applica automaticamente ogni segnale del browser.

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. Attiva l'API e copia la tua chiave

    Scegli un piano Fingerprint API attivo e usa una chiave API Capzy del tuo account. Salvala come CAPZY_API_KEY.

    Apri Fingerprint API
  2. Scegli i vincoli dell'identità

    Invia format=chromium, un tag di OS e un codice paese. Riutilizza id, uuid o seed con le stesse opzioni per rigenerare un'identità.

  3. Applica i campi supportati al tuo browser

    L'esempio Playwright applica user agent, lingua, fuso orario e viewport. Canvas, WebGL e altri segnali richiedono un supporto specifico del browser; consulta la guida completa.

Scegli il profilo che ti serve

La chiave è obbligatoria. Le opzioni di identità e di filtro sono facoltative; mantienile coerenti quando rigeneri un profilo.

keyObbligatorio · chiave API
La tua chiave API Capzy. Tienila sul server e lontana dal JavaScript del browser, dai repository pubblici e dagli URL di richiesta registrati nei log.
id / uuid / seedFacoltativo · identità
Selettori di identità alternativi. Fornisci un valore stabile e riutilizza la stessa configurazione dei filtri per una generazione deterministica. Omettili per una nuova identità.
formatPredefinito · chromium
Scegli chromium per la struttura JSON orientata al browser usata in questi esempi, oppure raw per la rappresentazione grezza del profilo.
tagsFacoltativo · OS
Filtra la famiglia di dispositivi, ad esempio Windows, macOS o Linux. Mantieni l'OS richiesto coerente con il browser che usi.
countryFacoltativo · codice di due lettere
Imposta la lingua e le indicazioni regionali del profilo. Il paese di un fingerprint non è un proxy; configura l'uscita del browser separatamente quando conta la posizione dell'IP.
min_browser_version / browser_versionFacoltativo · vincoli di versione
Filtra le versioni consultando il riferimento API completo. build_version e force_browser_version offrono controlli aggiuntivi; usa valori supportati dalla tua integrazione del browser.

Leggi un fingerprint per gruppi

Una risposta abbreviata e illustrativa. La risposta della tua API contiene il fingerprint completo e può variare in base a dispositivo e formato.

L'esempio Playwright applica user agent, lingua, fuso orario e viewport. Canvas, WebGL e altri segnali richiedono un supporto specifico del browser; consulta la guida completa.
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
  }
}

Scegli un paese

Paesi supportati (47)

Passa country (ISO 3166-1 alpha-2). Lingua, Accept-Language fuso orario, voci di sintesi vocale e font locali vengono impostati di conseguenza.

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

Visualizzati tutti i 47, scorri o cerca

Prezzi

I piani mensili attuali e i limiti di richieste vengono caricati dal catalogo pubblico. Verifica la tua quota attiva nella dashboard.

Caricamento dei prezzi attuali…

Alcune cose da sapere

Il JSON modifica automaticamente il mio browser?

No. La tua integrazione deve applicare ogni impostazione supportata. Le opzioni di contesto di Playwright coprono alcuni campi, mentre i segnali più profondi richiedono un browser o un'integrazione progettati per utilizzarli.

Il paese di un fingerprint è lo stesso del paese di un proxy?

No. Le impostazioni del fingerprint controllano i segnali di dispositivo e lingua. Un proxy controlla l'uscita di rete. Mantienili allineati quando il tuo flusso di lavoro richiede un'identità regionale coerente.

E se raggiungo un limite di frequenza?

Controlla la quota di richieste al minuto del tuo piano attivo ed eventuali limiti dell'organizzazione. Metti in coda o rallenta le richieste invece di riprovare ripetutamente alla stessa frequenza.

Costruisci una sessione coerente fin dall'inizio.

Genera un profilo, esaminane i campi e applicali seguendo la guida all'integrazione.

Apri la dashboard