TaskNet
  • Welcome to TaskNet Documentation
  • 🚀Getting Started
    • Authentication
      • API KEY
      • Environments
      • Fingerprints
    • Private Vs Public
    • QuickStart
  • Node Operators
    • Becoming a Node Operator
  • 📕Features
    • Browser Sessions
      • Automation Script Support
      • Automation with API
      • Real-Time View
      • File Downloads, and Uploads
    • User Fingerprints
      • Proxy
      • Chrome Extensions
  • 📚Guides
    • Running Automation Scripts
    • RealTime View
  • reference
    • Typescript SDK
      • NodeJS/Typescript
    • API Reference
      • Sessions
      • Enviornments
      • Fingerprints
      • Extensions
      • Page
      • Operators
  • What's New
    • Changelog
  • Socials
    • X
    • Github
    • Linkedin
    • Discord
Powered by GitBook
On this page
  1. reference
  2. API Reference

Fingerprints

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

PreviousEnviornmentsNextExtensions

Last updated 1 month 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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/{fingerprintUUID}' \
  --header 'X-Api-Key: YOUR_API_KEY'
200
{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": true,
  "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"
}

Fingerprint details

ListFingerprints

get
Authorizations
Path parameters
modestringrequired
Query parameters
limitintegeroptionalExample: 100
Responses
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints' \
  --header 'X-Api-Key: YOUR_API_KEY'
200
{
  "fingerprints": [
    {
      "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
      "isArchived": true,
      "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
}

List of fingerprints

  • GETGetFingerprint
  • GETListFingerprints
  • POSTCreateFingerprint
  • POSTCreateRandomFingerprint
  • POSTArchiveFingerprint
  • POSTCloneFingerprint
  • POSTResetFingerprint
  • PATCHUpdateFingerprintProxy

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
screenobjectrequired

deviceobjectoptional

proxyobjectoptional

extensionsstring[]optionalDefault: []
Responses
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "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
{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": true,
  "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"
}

Created fingerprint

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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/random' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "environmentUUID": "123e4567-e89b-12d3-a456-426614174000"
  }'
200
{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": true,
  "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"
}

Created random fingerprint

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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/{fingerprintUUID}/archive' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'
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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/{fingerprintUUID}/clone' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'
200
{
  "fingerprintUUID": "3e51d0d4-d4e1-41e3-a6ed-1ec9de11651c",
  "isArchived": true,
  "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"
}

Fingerprint cloned

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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/{fingerprintUUID}/reset' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{}'
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
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request PATCH \
  --url 'https://api.tasknet.co/{mode}/v1/fingerprints/{fingerprintUUID}/proxy' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "country": "US"
  }'
200
{}

Proxy settings updated