PerimeterX Solver API

The Solverify PerimeterX Solver API creates a browser-based task for PerimeterX protected pages and returns PerimeterX cookies in solution.cookies. Use this task type when you have the target URL and the PerimeterX pxAppId.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Full URL of the target page.
`websiteKey`	Yes	PerimeterX `pxAppId`.
`uuid`	No	PerimeterX UUID value when available.
`vid`	No	PerimeterX VID value when available.
`useragent`	No	User-agent string used for the request.
`proxyType`	Yes	Proxy type. Only `http` is accepted.
`proxyAddress`	Yes	Proxy IP address or hostname.
`proxyPort`	Yes	Proxy port. Numeric string, 1 to 5 digits.
`proxyLogin`	No	Proxy username.
`proxyPassword`	No	Proxy password.

By default, the solver waits for the _pxhd cookie. If you do not want this behavior, append |nopxhd to the end of websiteURL.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "perimeterx",
    "websiteURL": "https://example.com",
    "websiteKey": "PXHYx10rg3",
    "uuid": "your-px-uuid-here",
    "vid": "your-px-vid-here",
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "80",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Create Response

{
  "errorId": 0,
  "taskId": "UUID"
}

Result Example

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "",
    "cookies": {
      "_px3": "37624",
      "_pxvid": "254"
    },
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36"
  },
  "errorCode": null,
  "errorDescription": null
}

Timeout

PerimeterX tasks can run for up to about 180 seconds before timing out internally.

Next Steps

After creating a PerimeterX task, poll the Get Task Result API with the returned taskId. For validation and capacity errors, see Solverify API Error Codes.