Browser Launch

The browser launch endpoint is made for getting the --ateratti-key value, which you are supposed to then pass to the browser executable as a command line argument.

The fingerprint returned will be the result of combining data from up to three different sources:

1. Data provided in the request body takes precedence over data from the database and geo lookup.
2. Data from the database takes precedence over geo lookup.
3. Geo lookup is only used to fill geo-specific fields that weren't provided in the request or by the database.

Endpoint

POST /launch?id={id}&ip={ip}

Query parameters

id

string

required

The ID of the fingerprint

ip

string

required

Possible values: an IPv4 or IPv6 address
The IP address for geo lookup. If omitted, the IP address from which the request is made will be used

IMPORTANT

You must provide either an id or the preset (to generate a new fingerprint), but not both simultaneously

Request body

An optional 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

IMPORTANT

You must provide either an id or the preset (to generate a new fingerprint), but not both simultaneously

Response body

A JSON object representing the resulting fingerprint, with several additional keys, most notably the ateratti_key for launching the browser

ateratti_key

string

required

The --ateratti-key argument to launch the browser with

WARNING

All fields listed below are primarily intended for debugging purposes or to verify the correctness of your implementation. They may be changed or removed, and this won't be treated as a breaking change

---

extras

array<string>

required

PLAN

An array of extras included in your plan, e.g., akamai, kasada, udp_rtc, udp_quic, etc.

---

version

string

required

CHROME

The current newest Chrome version, usually one major release higher than the fallback_version. The browser will use this value if:

• The major versions match, or
• the browser's major version is two or more versions older:
  • version equals 124.0.6367.208
  • Browser version is 124.0.6367.91 -> will use version
  • Browser version is 123.0.6312.122 -> will use fallback_version if it matches
  • Browser version is 122.0.6261.94 -> will use version without trying fallback_version

fallback_version

string

required

CHROME

A fallback version to use if the browser's major version and version do not match

---

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": 2560,
        "h": 1440
    },
    "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 query = new URLSearchParams({
    id: "22de14c6-ac0a-4919-81d2-eb5bf571e8a1",
    ip: "11.22.33.44",
});

const response = await fetch(`https://api.ateratti.com/launch?${query}`, {
    method: "POST",
    headers: { "X-Api-Key": "Your API key" },
    body: JSON.stringify({
        screen: {
            w: 2560,
            h: 1440,
        },
    }),
});

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

const aterattiKey = fp["ateratti_key"];

Example response

200 OK

{
    "ateratti_key": "W7xUeqJ1t+uOW8AkSKhCe...jqJmUAgkRR4QuxV9Hum5A==",
    "extras": [],
    "version": "125.0.6422.61",
    "fallback_version": "124.0.6367.208",
    "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"
}

404 Not Found

{
    "message": "Fingerprint with the specified ID does not exist"
}

Error responses

Code	Description
400 Bad Request	The request is invalid
404 Not Found	There's no fingerprint with the specified ID