Create Fingerprint

Create a new fingerprint object

Endpoint

POST /fp

Request body

A JSON object containing fingerprint fields:

preset

string

required

FP

Possible values: [windows, windows10, windows11, ubuntu, ubuntu20, ubuntu22, ubuntu24]
The preset used to generate OS-specific parameters, e.g., user agent, navigator platform, speech synthesis voices, etc. If you specify only the OS type without a version (for example, windows instead of windows10), the version will be selected randomly.

seed

string

required

FP

The seed for the random number generator, used for choosing user agent minor version, and non-unique hardware fingerprints if your plan supports that.

screen

object

required

FP

The screen resolution. The object must have w and h fields, e.g., { "w": 1920, "h": 1080 }

platform_version

string

required

FP

Possible values for Windows: [10.0.0, 14.0.0, 15.0.0] (Win10 / Win11 / Win11)
Possible values for Linux: [5.15.0, 6.5.0, 6.8.0] (Ubuntu 20 / Ubuntu 22 / Ubuntu 24)
The Client Hints platform version

arch

string

required

FP

Possible values: [x64, arm]
Currently, x64 is the only supported value

cpu

int

required

FP

Possible values: >= 1
The number of virtual CPU cores

ram

int

required

FP

Possible values: [1, 2, 4, 8]
The amount of device RAM (in GB). Chrome has capped navigator.deviceMemory values at a maximum of 8, so it is set as the upper limit

gl_vendor

string

required

FP

Possible values for Windows: [Google Inc. (Intel), Google Inc. (NVIDIA), Google Inc. (AMD), Google Inc. (Google)]
Possible values for Linux: [Google Inc. (NVIDIA Corporation), Google Inc. (Google)]
The WebGL vendor

gl_renderer

string

required

FP

The WebGL renderer, e.g., ANGLE (Intel, Intel(R) HD Graphics 620 (0x00005921) Direct3D11 vs_5_0 ps_5_0, D3D11)

---

country_code

string

required

GEO

Possible values: 2 character string, case-insensitive
A two-letter country code provided in the ISO 3166-1 alpha-2 format, e.g., DE, US, CA. Used to fill speech synthesis voices and languages if they are not set in the fingerprint

languages

string

required

GEO

A comma-separated list of languages, e.g., de-DE,de,en-US,en

tz

string

required

GEO

The timezone, e.g., Europe/Berlin

ip4

string

required

GEO

The IPv4 address to use when spoofing WebRTC

ip6

string

required

GEO

The IPv6 address to use when spoofing WebRTC

You can omit all fields except for preset and let the rest be filled automatically. Geo-specific fields (starting with country_code) won't be filled unless provided in the request

Response body

A JSON object representing the newly created resource. Will contain the id and user_id on top of the provided fields:

id

string

required

DB

The ID of the fingerprint object

user_id

string

required

DB

The ID of the user owning the resource

---

preset

string

required

FP

Possible values: [windows10, windows11, ubuntu20, ubuntu22, ubuntu24]
The preset used to generate OS-specific parameters, e.g., user agent, navigator platform, speech synthesis voices, etc.

seed

string

required

FP

The seed for the random number generator, used for choosing user agent minor version, and non-unique hardware fingerprints if your plan supports that.

screen

object

required

FP

The screen resolution. The object must have w and h fields, e.g., { "w": 1920, "h": 1080 }

platform_version

string

required

FP

Possible values for Windows: [10.0.0, 14.0.0, 15.0.0] (Win10 / Win11 / Win11)
Possible values for Linux: [5.15.0, 6.5.0, 6.8.0] (Ubuntu 20 / Ubuntu 22 / Ubuntu 24)
The Client Hints platform version

arch

string

required

FP

Possible values: [x64, arm]
Currently, x64 is the only supported value

cpu

int

required

FP

Possible values: >= 1
The number of virtual CPU cores

ram

int

required

FP

Possible values: [1, 2, 4, 8]
The amount of device RAM (in GB). Chrome has capped navigator.deviceMemory values at a maximum of 8, so it is set as the upper limit

gl_vendor

string

required

FP

Possible values for Windows: [Google Inc. (Intel), Google Inc. (NVIDIA), Google Inc. (AMD), Google Inc. (Google)]
Possible values for Linux: [Google Inc. (NVIDIA Corporation), Google Inc. (Google)]
The WebGL vendor

gl_renderer

string

required

FP

The WebGL renderer, e.g., ANGLE (Intel, Intel(R) HD Graphics 620 (0x00005921) Direct3D11 vs_5_0 ps_5_0, D3D11)

---

country_code

string

required

GEO

Possible values: 2 character string, case-insensitive
A two-letter country code provided in the ISO 3166-1 alpha-2 format, e.g., DE, US, CA. Used to fill speech synthesis voices and languages if they are not set in the fingerprint

languages

string

required

GEO

A comma-separated list of languages, e.g., de-DE,de,en-US,en

tz

string

required

GEO

The timezone, e.g., Europe/Berlin

ip4

string

required

GEO

The IPv4 address to use when spoofing WebRTC

ip6

string

required

GEO

The IPv6 address to use when spoofing WebRTC

Example request

JSON body

{
    "preset": "windows10",
    "screen": {
        "w": 1920,
        "h": 1080
    },
    "platform_version": "10.0.0",
    "arch": "x64",
    "cpu": 4,
    "ram": 8,
    "gl_vendor": "Google Inc. (NVIDIA)",
    "gl_renderer": "ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 (0x00002504) Direct3D11 vs_5_0 ps_5_0, D3D11)",
    "country_code": "GB",
    "languages": "en-GB,en-US,en",
    "tz": "Europe/London",
    "ip4": "11.22.33.44",
    "ip6": "11:22::33:44"
}

JS + Fetch

const response = await fetch("https://api.ateratti.com/fp", {
    method: "POST",
    headers: { "X-Api-Key": "Your API key" },
    body: JSON.stringify({
        preset: "windows10",
        screen: {
            w: 1920,
            h: 1080,
        },
        platform_version: "10.0.0",
        arch: "x64",
        cpu: 4,
        ram: 8,
        gl_vendor: "Google Inc. (NVIDIA)",
        gl_renderer: "ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 (0x00002504) Direct3D11 vs_5_0 ps_5_0, D3D11)",
        country_code: "GB",
        languages: "en-GB,en-US,en",
        tz: "Europe/London",
        ip4: "11.22.33.44",
        ip6: "11:22::33:44",
    }),
});

const fp = await response.json();
console.log(fp);

Example response

200 OK

{
    "id": "22de14c6-ac0a-4919-81d2-eb5bf571e8a1",
    "user_id": "314b9e8c-4212-49e2-9d12-ae16e576d4e8",
    "preset": "windows10",
    "screen": {
        "w": 1920,
        "h": 1080
    },
    "platform_version": "10.0.0",
    "arch": "x64",
    "cpu": 4,
    "ram": 8,
    "gl_vendor": "Google Inc. (NVIDIA)",
    "gl_renderer": "ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 (0x00002504) Direct3D11 vs_5_0 ps_5_0, D3D11)",
    "country_code": "GB",
    "languages": "en-GB,en-US,en",
    "tz": "Europe/London",
    "ip4": "11.22.33.44",
    "ip6": "11:22::33:44"
}

400 Not Found

{
    "message": "Empty body"
}

Error responses

Code	Description
400 Bad Request	The request body contains invalid data
403 Forbidden	You have reached the limit for creating new fingerprints