Capzy Fingerprint API. Crie uma identidade coerente.
Gere um fingerprint de navegador em JSON. Escolha um sistema operacional e um país, reutilize uma identidade quando uma sessão voltar e mapeie a saída para as configurações suportadas pelo seu navegador.
customer-123en-US / America/New_YorkGere um perfil e depois aplique suas configurações
Comece com uma requisição de fingerprint. Use os campos da resposta que o seu framework de automação suporta; baixar o JSON não aplica automaticamente todos os sinais do navegador.
# 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"])Ative a API e copie sua chave
Escolha um plano ativo da Fingerprint API e use uma chave de API da Capzy da sua conta. Armazene-a como CAPZY_API_KEY.
Abrir Fingerprint APIEscolha as restrições da identidade
Envie format=chromium, uma tag de sistema operacional e um código de país. Reutilize id, uuid ou seed com as mesmas opções para gerar novamente uma identidade.
Aplique os campos suportados ao seu navegador
O exemplo com Playwright aplica user agent, localidade, fuso horário e viewport. Canvas, WebGL e outros sinais exigem suporte específico do navegador; consulte o guia completo.
Escolha o perfil de que você precisa
A chave é obrigatória. As opções de identidade e de filtragem são opcionais; mantenha-as consistentes ao gerar um perfil novamente.
keyObrigatório · chave de API- Sua chave de API da Capzy. Mantenha-a no servidor e fora do JavaScript do navegador, de repositórios públicos e de URLs de requisição registradas em log.
id / uuid / seedOpcional · identidade- Seletores de identidade alternativos. Informe um valor estável e reutilize a mesma configuração de filtros para uma geração determinística. Omita-os para obter uma nova identidade.
formatPadrão · chromium- Escolha chromium para a estrutura JSON orientada a navegador usada nestes exemplos ou raw para a representação bruta do perfil.
tagsOpcional · sistema operacional- Filtre a família do dispositivo, por exemplo Windows, macOS ou Linux. Mantenha o sistema operacional solicitado consistente com o navegador que você usa.
countryOpcional · código de duas letras- Define a localidade e indicações regionais do perfil. O país de um fingerprint não é um proxy; configure a saída do navegador separadamente quando a localização do IP importar.
min_browser_version / browser_versionOpcional · restrições de versão- Filtre versões consultando a referência completa da API. build_version e force_browser_version oferecem controles adicionais; use valores que a integração do seu navegador suporte.
Leia um fingerprint em grupos
Uma resposta resumida e ilustrativa. A resposta da sua API contém o fingerprint completo e pode variar conforme o dispositivo e o 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
}
}Escolha um país
Países compatíveis (47)
Passe country (ISO 3166-1 alpha-2). Idioma, Accept-Language fuso horário, vozes de fala e fontes da localidade são todos ajustados para combinar.
Exibindo todos os 47, role ou pesquise
Preços
Os planos mensais e os limites de requisições atuais são carregados do catálogo público. Confirme sua cota ativa no painel.
Carregando preços atuais…
Algumas coisas para saber
O JSON altera meu navegador automaticamente?
Não. Sua integração precisa aplicar cada configuração suportada. As opções de contexto do Playwright cobrem alguns campos, enquanto sinais mais profundos exigem um navegador ou uma integração projetada para consumi-los.
O país do fingerprint é o mesmo que o país do proxy?
Não. As configurações de fingerprint controlam os sinais de dispositivo e de localidade. Um proxy controla a saída de rede. Mantenha-os alinhados quando o seu fluxo precisar de uma identidade regional consistente.
E se eu atingir um limite de taxa?
Confira a cota de requisições por minuto do seu plano ativo e eventuais limites da organização. Coloque as requisições em fila ou diminua o ritmo em vez de tentar novamente várias vezes na mesma taxa.
Construa uma sessão consistente desde o início.
Gere um perfil, examine seus campos e aplique-os usando o guia de integração.
