Fingerprints
Generate unique identifiers for your users to create a reusable environment of user session data, proxy, cookies and device configuration.
Retrieves detailed information about a specific fingerprint, including its configuration, proxy settings, and session status.
4137e748-96ce-4354-94c6-8ebfbb48d756
GET /{mode}/v1/fingerprints/{fingerprintUUID} HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Accept: */*
{
"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"
}
100
GET /{mode}/v1/fingerprints HTTP/1.1
Host: api.tasknet.co
X-Api-Key: YOUR_API_KEY
Accept: */*
{
"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
}
Creates a new fingerprint with specified browser configuration, device settings, and proxy settings. This fingerprint can be used to start new browser sessions.
[]
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"
]
}
{
"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"
}
Generates a new fingerprint with randomized browser configuration, device settings, and proxy settings.
UUID of the environment to create the fingerprint in
123e4567-e89b-12d3-a456-426614174000
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"
}
{
"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"
}
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.
4137e748-96ce-4354-94c6-8ebfbb48d756
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
{}
{}
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.
73f990f2-23cc-41b0-b3ca-f65b385083f5
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
{}
{
"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"
}
Deletes all session data associated with the fingerprint while preserving its configuration. This allows you to start fresh with the same fingerprint settings.
420c1e83-69d7-4b6d-b07e-50dc0b2d7cd7
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
{}
{}
Updates the proxy settings for a specific fingerprint. This allows you to change the geographic location and routing of browser traffic.
420c1e83-69d7-4b6d-b07e-50dc0b2d7cd7
Two-letter ISO country code for proxy location
US
Pattern: ^[A-Z]{2}$
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"
}
{}
Last updated