Aller au contenu

Capzy Fingerprint API. Construisez une identité cohérente.

Générez une empreinte de navigateur au format JSON. Choisissez un OS et un pays, réutilisez une identité lorsqu’une session revient, et reportez la sortie dans les paramètres pris en charge par votre navigateur.

Une identité, des signaux liésExemple illustratif
ID stablecustomer-123
Famille d’appareilsWindows · Chromium · 1920 × 1080
Locale + fuseau horaireen-US / America/New_York
Groupes de sortieUser agent, écran, navigator, graphismes et plus encore

Générez un profil, puis appliquez ses paramètres

Commencez par une requête d’empreinte. Utilisez les champs de réponse pris en charge par votre framework d’automatisation ; télécharger le JSON n’applique pas automatiquement chaque signal du navigateur.

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. Activez l’API et copiez votre clé

    Choisissez un forfait Fingerprint API actif et utilisez une clé API Capzy de votre compte. Enregistrez-la sous CAPZY_API_KEY.

    Ouvrir la Fingerprint API
  2. Choisissez les contraintes d’identité

    Envoyez format=chromium, un tag d’OS et un code pays. Réutilisez id, uuid ou seed avec les mêmes options pour régénérer une identité.

  3. Appliquez les champs pris en charge à votre navigateur

    L’exemple Playwright applique le user agent, la locale, le fuseau horaire et le viewport. Canvas, WebGL et les autres signaux nécessitent une prise en charge propre à chaque navigateur ; consultez le guide complet.

Choisissez le profil dont vous avez besoin

La clé est requise. Les options d’identité et de filtrage sont facultatives ; gardez-les identiques lorsque vous régénérez un profil.

keyRequis · clé API
Votre clé API Capzy. Gardez-la côté serveur, hors du JavaScript du navigateur, des dépôts publics et des URL de requêtes journalisées.
id / uuid / seedFacultatif · identité
Sélecteurs d’identité alternatifs. Fournissez une valeur stable et réutilisez la même configuration de filtres pour une génération déterministe. Omettez-les pour obtenir une nouvelle identité.
formatPar défaut · chromium
Choisissez chromium pour la structure JSON orientée navigateur utilisée dans ces exemples, ou raw pour la représentation brute du profil.
tagsFacultatif · OS
Filtrez la famille d’appareils, par exemple Windows, macOS ou Linux. Gardez l’OS demandé cohérent avec le navigateur que vous utilisez.
countryFacultatif · code à deux lettres
Définit la locale et les indices de profil régional. Le pays d’une empreinte n’est pas un proxy ; configurez séparément la sortie du navigateur si la localisation de l’IP compte.
min_browser_version / browser_versionFacultatif · contraintes de version
Filtrez les versions à l’aide de la référence complète de l’API. build_version et force_browser_version offrent des contrôles supplémentaires ; utilisez des valeurs prises en charge par votre intégration navigateur.

Lisez une empreinte par groupes

Une réponse illustrative et abrégée. La réponse de votre API contient l’empreinte complète et peut varier selon l’appareil et le format.

L’exemple Playwright applique le user agent, la locale, le fuseau horaire et le viewport. Canvas, WebGL et les autres signaux nécessitent une prise en charge propre à chaque navigateur ; consultez le guide complet.
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
  }
}

Choisissez un pays

Pays pris en charge (47)

Passez country (ISO 3166-1 alpha-2). La langue, Accept-Language, le fuseau horaire, les voix de synthèse et les polices régionales sont tous ajustés en conséquence.

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

Les 47 sont affichés, faites défiler ou recherchez

Tarifs

Les forfaits mensuels et limites de requêtes actuels sont chargés depuis le catalogue public. Vérifiez votre quota actif dans le tableau de bord.

Chargement des prix actuels…

Quelques points à connaître

Le JSON modifie-t-il automatiquement mon navigateur ?

Non. Votre intégration doit appliquer chaque paramètre pris en charge. Les options de contexte de Playwright couvrent certains champs, tandis que les signaux plus profonds nécessitent un navigateur ou une intégration conçus pour les exploiter.

Le pays d’une empreinte est-il le même que celui d’un proxy ?

Non. Les paramètres d’empreinte contrôlent les signaux d’appareil et de locale. Un proxy contrôle la sortie réseau. Gardez-les alignés lorsque votre workflow nécessite une identité régionale cohérente.

Que faire si j’atteins une limite de débit ?

Vérifiez le quota de requêtes par minute de votre forfait actif et les éventuelles limites de l’organisation. Mettez les requêtes en file d’attente ou ralentissez-les au lieu de réessayer sans cesse au même rythme.

Construisez une session cohérente dès le départ.

Générez un profil, examinez ses champs et appliquez-les à l’aide du guide d’intégration.

Ouvrir le tableau de bord