Fingerprints

Generate unique identifiers for your users to create a reusable environment of user session data, proxy, cookies and device configuration.

PreviousEnviornments NextExtensions

Last updated 3 months ago

GetFingerprint

get

Retrieves detailed information about a specific fingerprint, including its configuration, proxy settings, and session status.

Authorizations

Path parameters

modestringRequired

fingerprintUUIDstringRequiredExample: 4137e748-96ce-4354-94c6-8ebfbb48d756

Responses

200

Fingerprint details

application/json

get

GET /{mode}/v1/fingerprints/{fingerprintUUID} HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Accept: */*

200

Fingerprint details

{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": false,
  "browserConfig": {
    "browser": "chromium",
    "extensions": [
      "text"
    ],
    "numCameras": 1,
    "numMicrophones": 2,
    "numSpeakers": 2,
    "screenDPI": 96,
    "screenDepth": 24,
    "screenResolution": "1280x1024"
  },
  "proxy": {
    "appliedDomains": [
      "text"
    ],
    "city": "",
    "country": "",
    "state": "",
    "type": "residential"
  },
  "language": "en-US",
  "timeZone": "America/New_York",
  "platform": "Windows",
  "deviceType": "desktop",
  "createdAt": "2025-02-03T07:11:17.979Z",
  "updatedAt": "2025-02-03T07:11:17.979Z"
}

ListFingerprints

get

Authorizations

Path parameters

modestringRequired

Query parameters

limitintegerOptionalExample: 100

Responses

200

List of fingerprints

application/json

get

GET /{mode}/v1/fingerprints HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Accept: */*

200

List of fingerprints

{
  "fingerprints": [
    {
      "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
      "isArchived": false,
      "browserConfig": {
        "browser": "chromium",
        "extensions": [
          "text"
        ],
        "numCameras": 1,
        "numMicrophones": 2,
        "numSpeakers": 2,
        "screenDPI": 96,
        "screenDepth": 24,
        "screenResolution": "1280x1024"
      },
      "proxy": {
        "appliedDomains": [
          "text"
        ],
        "city": "",
        "country": "",
        "state": "",
        "type": "residential"
      },
      "language": "en-US",
      "timeZone": "America/New_York",
      "platform": "Windows",
      "deviceType": "desktop",
      "createdAt": "2025-02-03T07:11:17.979Z",
      "updatedAt": "2025-02-03T07:11:17.979Z"
    }
  ],
  "prevPage": 1,
  "nextPage": 1,
  "total": 1
}

CreateFingerprint

post

Creates a new fingerprint with specified browser configuration, device settings, and proxy settings. This fingerprint can be used to start new browser sessions.

Authorizations

Path parameters

modestringRequired

Body

environmentUUIDstring · uuidRequired

extensionsstring[]OptionalDefault: []

Responses

200

Created fingerprint

application/json

Responseall of

post

POST /{mode}/v1/fingerprints HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 222

{
  "environmentUUID": "123e4567-e89b-12d3-a456-426614174000",
  "screen": {
    "resolution": "1280x1024",
    "depth": 24,
    "dpi": 96
  },
  "device": {
    "numSpeakers": 2,
    "numMicrophones": 2,
    "numCameras": 1
  },
  "proxy": {
    "country": "US"
  },
  "extensions": [
    "text"
  ]
}

200

Created fingerprint

{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": false,
  "browserConfig": {
    "browser": "chromium",
    "extensions": [
      "text"
    ],
    "numCameras": 1,
    "numMicrophones": 2,
    "numSpeakers": 2,
    "screenDPI": 96,
    "screenDepth": 24,
    "screenResolution": "1280x1024"
  },
  "proxy": {
    "appliedDomains": [
      "text"
    ],
    "city": "",
    "country": "",
    "state": "",
    "type": "residential"
  },
  "language": "en-US",
  "timeZone": "America/New_York",
  "platform": "Windows",
  "deviceType": "desktop",
  "createdAt": "2025-02-03T07:11:17.979Z",
  "updatedAt": "2025-02-03T07:11:17.979Z",
  "fingerprintSecret": "text"
}

CreateRandomFingerprint

post

Generates a new fingerprint with randomized browser configuration, device settings, and proxy settings.

Authorizations

Path parameters

modestringRequired

Body

environmentUUIDstring · uuidRequired

UUID of the environment to create the fingerprint in

Example: 123e4567-e89b-12d3-a456-426614174000

Responses

200

Created random fingerprint

application/json

Responseall of

post

POST /{mode}/v1/fingerprints/random HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "environmentUUID": "123e4567-e89b-12d3-a456-426614174000"
}

200

Created random fingerprint

{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": false,
  "browserConfig": {
    "browser": "chromium",
    "extensions": [
      "text"
    ],
    "numCameras": 1,
    "numMicrophones": 2,
    "numSpeakers": 2,
    "screenDPI": 96,
    "screenDepth": 24,
    "screenResolution": "1280x1024"
  },
  "proxy": {
    "appliedDomains": [
      "text"
    ],
    "city": "",
    "country": "",
    "state": "",
    "type": "residential"
  },
  "language": "en-US",
  "timeZone": "America/New_York",
  "platform": "Windows",
  "deviceType": "desktop",
  "createdAt": "2025-02-03T07:11:17.979Z",
  "updatedAt": "2025-02-03T07:11:17.979Z",
  "fingerprintSecret": "text"
}

ArchiveFingerprint

post

Archives a fingerprint by deleting all associated session data and marking it as no longer usable. Once archived, the fingerprint cannot be used to create new sessions.

Authorizations

Path parameters

modestringRequired

fingerprintUUIDstringRequiredExample: 4137e748-96ce-4354-94c6-8ebfbb48d756

Body

objectOptional

Responses

200

Fingerprint archived

application/json

Responseobject

post

POST /{mode}/v1/fingerprints/{fingerprintUUID}/archive HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

Fingerprint archived

{}

CloneFingerprint

post

Creates a copy of an existing fingerprint's settings but generates new session data. This allows you to duplicate a successful configuration while maintaining unique session identifiers.

Authorizations

Path parameters

modestringRequired

fingerprintUUIDstringRequiredExample: 73f990f2-23cc-41b0-b3ca-f65b385083f5

Body

objectOptional

Responses

200

Fingerprint cloned

application/json

Responseall of

post

POST /{mode}/v1/fingerprints/{fingerprintUUID}/clone HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

Fingerprint cloned

{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": false,
  "browserConfig": {
    "browser": "chromium",
    "extensions": [
      "text"
    ],
    "numCameras": 1,
    "numMicrophones": 2,
    "numSpeakers": 2,
    "screenDPI": 96,
    "screenDepth": 24,
    "screenResolution": "1280x1024"
  },
  "proxy": {
    "appliedDomains": [
      "text"
    ],
    "city": "",
    "country": "",
    "state": "",
    "type": "residential"
  },
  "language": "en-US",
  "timeZone": "America/New_York",
  "platform": "Windows",
  "deviceType": "desktop",
  "createdAt": "2025-02-03T07:11:17.979Z",
  "updatedAt": "2025-02-03T07:11:17.979Z",
  "fingerprintSecret": "text"
}

ResetFingerprint

post

Deletes all session data associated with the fingerprint while preserving its configuration. This allows you to start fresh with the same fingerprint settings.

Authorizations

Path parameters

modestringRequired

fingerprintUUIDstringRequiredExample: 420c1e83-69d7-4b6d-b07e-50dc0b2d7cd7

Body

objectOptional

Responses

200

Fingerprint reset

application/json

Responseobject

post

POST /{mode}/v1/fingerprints/{fingerprintUUID}/reset HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

200

Fingerprint reset

{}

UpdateFingerprintProxy

patch

Updates the proxy settings for a specific fingerprint. This allows you to change the geographic location and routing of browser traffic.

Authorizations

Path parameters

modestringRequired

fingerprintUUIDstringRequiredExample: 420c1e83-69d7-4b6d-b07e-50dc0b2d7cd7

Body

countrystring · min: 2 · max: 2Required

Two-letter ISO country code for proxy location

Example: USPattern: ^[A-Z]{2}$

Responses

200

Proxy settings updated

application/json

Responseobject

patch

PATCH /{mode}/v1/fingerprints/{fingerprintUUID}/proxy HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "country": "US"
}

200

Proxy settings updated

{}