PerimeterX (HUMAN)

Solves PerimeterX / HUMAN Bot Defender sensor challenges. Returns _px3 and _pxvid cookies you attach to your requests. No browser required — solved via protocol-level replay with Chrome TLS fingerprint.

Task object

Send this as task in createTask.

PerimeterXTask fields
FieldTypeDescription
type RequiredstringAlways PerimeterXTask.
websiteURL RequiredstringThe URL of the page protected by PerimeterX.
appId OptionalstringThe PX app ID (starts with PX). Defaults to PXbf8PROpW if omitted.
JSON
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "PerimeterXTask",
    "websiteURL": "https://www.roblox.com/",
    "appId": "PXbf8PROpW"
  }
}

Finding the app ID

Open the page with your browser's developer tools and look for:

  • A script tag loading from client.px-cloud.net/PXxxxxxxxx/main.min.js.
  • A window._pxAppId assignment in the page source.
  • A request to collector-pxxxxxxxxx.px-cloud.net.

Solution

PerimeterX solution fields
FieldTypeDescription
token RequiredstringThe _px3 cookie value.
cookies OptionalobjectObject with _px3 and _pxvid cookie values.
cookieHeader OptionalstringReady-to-use Cookie header string: _px3=...; _pxvid=...
JSON
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "CFQIVFQIRGdIQAtECwsIRFwI...",
    "cookies": {
      "_px3": "CFQIVFQIRGdIQAtECwsIRFwI...",
      "_pxvid": "a1b2c3d4-e5f6-1789-abcd-ef0123456789"
    },
    "cookieHeader": "_px3=CFQIVFQIRGdI...; _pxvid=a1b2c3d4..."
  }
}

Set both _px3 and _pxvid cookies on your requests. The token is valid for the URL and app ID you specified. Tokens typically last a few minutes.