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.
customer-123en-US / America/New_YorkGenera 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.
# 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"])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 APIScegli 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à.
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.
{
"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.
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.
