# Scrapfly Documentation ## Table of Contents ### Dashboard - [Intro](https://scrapfly.io/docs) - [Project](https://scrapfly.io/docs/project) - [Account](https://scrapfly.io/docs/account) - [Workspace & Team](https://scrapfly.io/docs/workspace-and-team) - [Billing](https://scrapfly.io/docs/billing) ### Products #### MCP Server - [Getting Started](https://scrapfly.io/docs/mcp/getting-started) - [Tools & API Spec](https://scrapfly.io/docs/mcp/tools) - [Authentication](https://scrapfly.io/docs/mcp/authentication) - [Examples & Use Cases](https://scrapfly.io/docs/mcp/examples) - [FAQ](https://scrapfly.io/docs/mcp/faq) ##### Integrations - [Overview](https://scrapfly.io/docs/mcp/integrations) - [Claude Desktop](https://scrapfly.io/docs/mcp/integrations/claude-desktop) - [Claude Code](https://scrapfly.io/docs/mcp/integrations/claude-code) - [ChatGPT](https://scrapfly.io/docs/mcp/integrations/chatgpt) - [Cursor](https://scrapfly.io/docs/mcp/integrations/cursor) - [Cline](https://scrapfly.io/docs/mcp/integrations/cline) - [Windsurf](https://scrapfly.io/docs/mcp/integrations/windsurf) - [Zed](https://scrapfly.io/docs/mcp/integrations/zed) - [Roo Code](https://scrapfly.io/docs/mcp/integrations/roo-code) - [VS Code](https://scrapfly.io/docs/mcp/integrations/vscode) - [LangChain](https://scrapfly.io/docs/mcp/integrations/langchain) - [LlamaIndex](https://scrapfly.io/docs/mcp/integrations/llamaindex) - [CrewAI](https://scrapfly.io/docs/mcp/integrations/crewai) - [OpenAI](https://scrapfly.io/docs/mcp/integrations/openai) - [n8n](https://scrapfly.io/docs/mcp/integrations/n8n) - [Make](https://scrapfly.io/docs/mcp/integrations/make) - [Zapier](https://scrapfly.io/docs/mcp/integrations/zapier) - [Vapi AI](https://scrapfly.io/docs/mcp/integrations/vapi) - [Agent Builder](https://scrapfly.io/docs/mcp/integrations/agent-builder) - [Custom Client](https://scrapfly.io/docs/mcp/integrations/custom-client) #### Web Scraping API - [Getting Started](https://scrapfly.io/docs/scrape-api/getting-started) - [API Specification]() - [Monitoring](https://scrapfly.io/docs/monitoring) - [Customize Request](https://scrapfly.io/docs/scrape-api/custom) - [Debug](https://scrapfly.io/docs/scrape-api/debug) - [Anti Scraping Protection](https://scrapfly.io/docs/scrape-api/anti-scraping-protection) - [Proxy](https://scrapfly.io/docs/scrape-api/proxy) - [Proxy Mode](https://scrapfly.io/docs/scrape-api/proxy-mode) - [Proxy Mode - Screaming Frog](https://scrapfly.io/docs/scrape-api/proxy-mode/screaming-frog) - [Proxy Mode - Apify](https://scrapfly.io/docs/scrape-api/proxy-mode/apify) - [(Auto) Data Extraction](https://scrapfly.io/docs/scrape-api/extraction) - [Javascript Rendering](https://scrapfly.io/docs/scrape-api/javascript-rendering) - [Javascript Scenario](https://scrapfly.io/docs/scrape-api/javascript-scenario) - [SSL](https://scrapfly.io/docs/scrape-api/ssl) - [DNS](https://scrapfly.io/docs/scrape-api/dns) - [Cache](https://scrapfly.io/docs/scrape-api/cache) - [Session](https://scrapfly.io/docs/scrape-api/session) - [Webhook](https://scrapfly.io/docs/scrape-api/webhook) - [Screenshot](https://scrapfly.io/docs/scrape-api/screenshot) - [Errors](https://scrapfly.io/docs/scrape-api/errors) - [Timeout](https://scrapfly.io/docs/scrape-api/understand-timeout) - [Throttling](https://scrapfly.io/docs/throttling) - [Troubleshoot](https://scrapfly.io/docs/scrape-api/troubleshoot) - [Billing](https://scrapfly.io/docs/scrape-api/billing) - [FAQ](https://scrapfly.io/docs/scrape-api/faq) #### Crawler API - [Getting Started](https://scrapfly.io/docs/crawler-api/getting-started) - [API Specification]() - [Retrieving Results](https://scrapfly.io/docs/crawler-api/results) - [WARC Format](https://scrapfly.io/docs/crawler-api/warc-format) - [Data Extraction](https://scrapfly.io/docs/crawler-api/extraction-rules) - [Webhook](https://scrapfly.io/docs/crawler-api/webhook) - [Billing](https://scrapfly.io/docs/crawler-api/billing) - [Errors](https://scrapfly.io/docs/crawler-api/errors) - [Troubleshoot](https://scrapfly.io/docs/crawler-api/troubleshoot) - [FAQ](https://scrapfly.io/docs/crawler-api/faq) #### Screenshot API - [Getting Started](https://scrapfly.io/docs/screenshot-api/getting-started) - [API Specification]() - [Accessibility Testing](https://scrapfly.io/docs/screenshot-api/accessibility) - [Webhook](https://scrapfly.io/docs/screenshot-api/webhook) - [Billing](https://scrapfly.io/docs/screenshot-api/billing) - [Errors](https://scrapfly.io/docs/screenshot-api/errors) #### Extraction API - [Getting Started](https://scrapfly.io/docs/extraction-api/getting-started) - [API Specification]() - [Rules Template](https://scrapfly.io/docs/extraction-api/rules-and-template) - [LLM Extraction](https://scrapfly.io/docs/extraction-api/llm-prompt) - [AI Auto Extraction](https://scrapfly.io/docs/extraction-api/automatic-ai) - [Webhook](https://scrapfly.io/docs/extraction-api/webhook) - [Billing](https://scrapfly.io/docs/extraction-api/billing) - [Errors](https://scrapfly.io/docs/extraction-api/errors) - [FAQ](https://scrapfly.io/docs/extraction-api/faq) #### Proxy Saver - [Getting Started](https://scrapfly.io/docs/proxy-saver/getting-started) - [Fingerprints](https://scrapfly.io/docs/proxy-saver/fingerprints) - [Optimizations](https://scrapfly.io/docs/proxy-saver/optimizations) - [SSL Certificates](https://scrapfly.io/docs/proxy-saver/certificates) - [Protocols](https://scrapfly.io/docs/proxy-saver/protocols) - [Pacfile](https://scrapfly.io/docs/proxy-saver/pacfile) - [Secure Credentials](https://scrapfly.io/docs/proxy-saver/security) - [Billing](https://scrapfly.io/docs/proxy-saver/billing) #### Cloud Browser API - [Getting Started](https://scrapfly.io/docs/cloud-browser-api/getting-started) - [Proxy & Geo-Targeting](https://scrapfly.io/docs/cloud-browser-api/proxy) - [Unblock API](https://scrapfly.io/docs/cloud-browser-api/unblock) - [File Downloads](https://scrapfly.io/docs/cloud-browser-api/file-downloads) - [Session Resume](https://scrapfly.io/docs/cloud-browser-api/session-resume) - [Human-in-the-Loop](https://scrapfly.io/docs/cloud-browser-api/human-in-the-loop) - [Debug Mode](https://scrapfly.io/docs/cloud-browser-api/debug-mode) - [Bring Your Own Proxy](https://scrapfly.io/docs/cloud-browser-api/bring-your-own-proxy) - [Browser Extensions](https://scrapfly.io/docs/cloud-browser-api/extensions) ##### Integrations - [Puppeteer](https://scrapfly.io/docs/cloud-browser-api/puppeteer) - [Playwright](https://scrapfly.io/docs/cloud-browser-api/playwright) - [Selenium](https://scrapfly.io/docs/cloud-browser-api/selenium) - [Vercel Agent Browser](https://scrapfly.io/docs/cloud-browser-api/agent-browser) - [Browser Use](https://scrapfly.io/docs/cloud-browser-api/browser-use) - [Stagehand](https://scrapfly.io/docs/cloud-browser-api/stagehand) - [Billing](https://scrapfly.io/docs/cloud-browser-api/billing) - [Errors](https://scrapfly.io/docs/cloud-browser-api/errors) ### Tools - [Antibot Detector](https://scrapfly.io/docs/tools/antibot-detector) ### SDK - [Golang](https://scrapfly.io/docs/sdk/golang) - [Python](https://scrapfly.io/docs/sdk/python) - [Rust](https://scrapfly.io/docs/sdk/rust) - [TypeScript](https://scrapfly.io/docs/sdk/typescript) - [Scrapy](https://scrapfly.io/docs/sdk/scrapy) ### Integrations - [Getting Started](https://scrapfly.io/docs/integration/getting-started) - [LangChain](https://scrapfly.io/docs/integration/langchain) - [LlamaIndex](https://scrapfly.io/docs/integration/llamaindex) - [CrewAI](https://scrapfly.io/docs/integration/crewai) - [Zapier](https://scrapfly.io/docs/integration/zapier) - [Make](https://scrapfly.io/docs/integration/make) - [n8n](https://scrapfly.io/docs/integration/n8n) ### Academy - [Overview](https://scrapfly.io/academy) - [Web Scraping Overview](https://scrapfly.io/academy/scraping-overview) - [Tools](https://scrapfly.io/academy/tools-overview) - [Reverse Engineering](https://scrapfly.io/academy/reverse-engineering) - [Static Scraping](https://scrapfly.io/academy/static-scraping) - [HTML Parsing](https://scrapfly.io/academy/html-parsing) - [Dynamic Scraping](https://scrapfly.io/academy/dynamic-scraping) - [Hidden API Scraping](https://scrapfly.io/academy/hidden-api-scraping) - [Headless Browsers](https://scrapfly.io/academy/headless-browsers) - [Hidden Web Data](https://scrapfly.io/academy/hidden-web-data) - [JSON Parsing](https://scrapfly.io/academy/json-parsing) - [Data Processing](https://scrapfly.io/academy/data-processing) - [Scaling](https://scrapfly.io/academy/scaling) - [Walkthrough Summary](https://scrapfly.io/academy/walkthrough-summary) - [Scraper Blocking](https://scrapfly.io/academy/scraper-blocking) - [Proxies](https://scrapfly.io/academy/proxies) --- # Getting Started with Fingerprint API [ View as markdown ](https://scrapfly.io/?view=markdown) Copy for LLM Copy for LLM [ Open in ChatGPT ](https://chatgpt.com/?hints=search&prompt=Read%20from%20https%3A%2F%2Fscrapfly.io%2Fdocs%2Ffingerprint-api%2Fgetting-started%20so%20I%20can%20ask%20questions%20about%20it.) [ Open in Claude ](https://claude.ai/new?q=Read%20from%20https%3A%2F%2Fscrapfly.io%2Fdocs%2Ffingerprint-api%2Fgetting-started%20so%20I%20can%20ask%20questions%20about%20it.) [ Open in Perplexity ](https://www.perplexity.ai/search/new?q=Read%20from%20https%3A%2F%2Fscrapfly.io%2Fdocs%2Ffingerprint-api%2Fgetting-started%20so%20I%20can%20ask%20questions%20about%20it.) The **Fingerprint API** generates complete, realistic browser fingerprints for anti-detection purposes. Each fingerprint includes HTTP headers, navigator properties, screen dimensions, GPU profiles, WebRTC configuration, TLS settings, and more — all consistent and internally coherent. **Beta Feature:** The Fingerprint API is currently in beta and available to staff members only. ## Key Features ##### Multi-Brand Support Generate fingerprints for Chrome, Microsoft Edge, Brave, and Opera — each with correct brand headers and user-agent strings ##### Seed-Based Reproducibility Use integer seeds to generate deterministic fingerprints — the same seed always produces the same fingerprint ##### Geo-Aware Localization Automatic timezone, locale, and language configuration based on country code with daylight cycle awareness ##### Hardware Fingerprinting Realistic GPU models, screen resolutions, CPU cores, device memory, and audio context profiles ##### Headless & Headfull Modes Generate fingerprints optimized for headless automation or headfull (GUI) browser sessions ##### WebRTC & TLS Consistent WebRTC configuration with proxy-aware IP handling and realistic TLS fingerprints ## Quick Start Generate a fingerprint with a single API call. The minimal request only needs your API key: ``` curl 'https://api.scrapfly.io/fingerprint/generator?key=&os=windows&country=us' ``` For more control, specify the browser brand, version, and screen resolution: ``` curl 'https://api.scrapfly.io/fingerprint/generator?key=&os=windows&country=fr&browser_brand=edge&version=145&screen_resolution=1920x1080' ``` ## Supported Browser Brands The Fingerprint API supports four Chromium-based browser brands. Each brand generates correct `sec-ch-ua` headers, user-agent strings, and brand-specific version numbering. | Brand | Parameter Value | Supported Platforms | UA Suffix | |---|---|---|---| | **Google Chrome** | `chrome` | Windows, macOS, Linux | *none* | | **Microsoft Edge** | `edge` | Windows only | `Edg/{version}` | | **Brave** | `brave` | Windows, macOS, Linux | *none* | | **Opera** | `opera` | Windows, macOS, Linux | `OPR/{version}` | **Platform constraint:** Microsoft Edge fingerprints are only available for the `windows` platform. Requesting Edge with `linux` or `mac` will return an error. ## Response Structure The fingerprint response contains several sections, each providing a different aspect of the browser identity: | Section | Description | |---|---| | `headers` | HTTP request headers including `user-agent`, `sec-ch-ua`, `sec-ch-ua-full-version-list`, `accept-language`, and all client hints | | `browser` | Complete browser identity: `navigator` properties, `userAgentData` with brand list, `webglContext`/`webgl2Context` GPU profiles, `webRTC` ICE candidates, `window` dimensions, `fonts`, `plugins`, `permissions`, and more | | `hardware` | Hardware fingerprint data including storage quota | | `system` | OS-level data: `osType`, `osVersion`, system fonts, media devices, MIME types, and memory patterns | | `geo` | Timezone, locale, languages, geographic coordinates, daylight status, and local time | | `network` | Public IP, local IP, DNS entries, DNS resolvers, and internet latency simulation | | `noises` | Canvas 2D, WebGL, audio, client rects, text metrics, HarfBuzz, and CSS trig noise factors for fingerprint randomization | | `seed` | The integer seed used to generate this fingerprint (for reproducibility) | ## Seed-Based Reproducibility Every fingerprint is generated using an integer seed that determines all random choices (GPU model, screen resolution, browser version, etc.). Using the same seed with the same parameters always produces an identical fingerprint: ``` curl 'https://api.scrapfly.io/fingerprint/generator?key=&os=windows&country=us&seed=12345' ``` The `seed` field is always included in the response, so you can store it and reproduce the exact same fingerprint later. If no seed is provided, one is randomly generated. ## Scrapium Format For integration with **Scrapium** (Scrapfly's browser automation framework), use the `scrapium_format=true` parameter. This returns the fingerprint in Scrapium's native format with an additional `variables` section containing CLI arguments for launching Chrome: ``` curl 'https://api.scrapfly.io/fingerprint/generator?key=&os=windows&country=us&scrapium_format=true&headless=true' ``` The Scrapium format includes: - `variables.cliArgs` — Chrome command-line flags for fingerprint injection - `variables.headless` — Whether the browser runs in headless mode - `variables.proxyConfig` — Proxy connection details (if proxy parameters were provided) ## Discovering Available Options Use the `/fingerprint/options` endpoint to discover available screen resolutions, GPU models, browser versions, and brand-specific data for a given platform: ``` curl 'https://api.scrapfly.io/fingerprint/options?key=&os=windows' ``` This returns lists of valid values you can use in the `/fingerprint/generator` parameters. The `brand_data` field shows per-brand version lists and platform support. ## API Playground Try the Fingerprint API interactively using the [ API Player](https://scrapfly.io/dashboard/playground/fingerprint) in the dashboard. It provides a visual interface for selecting all parameters and previewing the generated fingerprint. ## Related Documentation - [Getting Started](https://scrapfly.io/docs/fingerprint-api/getting-started) — Full parameter reference - [Fingerprint API Player](https://scrapfly.io/dashboard/playground/fingerprint) — Interactive playground