PerimeterXInvisibleToken
Generate PerimeterX sensor data from the init.js script through your proxy and get the PerimeterX cookies, with no challenge page needed.
PerimeterXInvisibleToken runs the PerimeterX flow for a site's init.js through your proxy and returns the PerimeterX cookies. PerimeterX scripts collect browser signals on the page and post them to PerimeterX, which answers with cookies such as _px3. No block page is involved.
If you are looking at a block page with a Press & Hold button, use PerimeterXHoldToken. If you have only the app ID and the provider network is acceptable, use PerimeterXInvisibleTokenProxyLess.
Which PerimeterX task do I need?
| What you have | Task |
|---|---|
| You see a block page with a Press & Hold button, and solve through your proxy | PerimeterXHoldToken |
You have the init.js URL and the app ID, and solve through your proxy | PerimeterXInvisibleToken (this task) |
| You have only the app ID, and want the provider's invisible task, from the provider network | PerimeterXInvisibleTokenProxyLess |
| You have only the app ID, and want the provider's standard task, from the provider network | PerimeterXTokenProxyLess |
Use your proxy
task.proxy is required on this task type. The provider solves from that address, and the proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve. Replay the cookies from the same IP and with the same User-Agent.
Find the parameters
Open the protected page with DevTools and the Network tab:
| Field | Where to find it |
|---|---|
pxAppId | The app ID: PX followed by letters and digits. It is in the init.js request URL and in window._pxAppId in the console. |
perimeterxJsUrl | The full URL of the init.js request. Sites that serve it first-party use a path such as /px/PXxxxxxxxx/init.js on their own domain, where PXxxxxxxxx is the app ID. |
Send the protected page as websiteURL.
Use the cookies
Set every cookie in solution.cookies on the session before you request the protected endpoints, and send the returned userAgent when the provider supplies one. If the site rejects the cookies, check that the proxy kept one IP for the whole solve, then that pxAppId and perimeterxJsUrl come from the protected page.
Check Provider stats for live success rates and solve times before you pick a provider.
Supported Providers
| Provider | Price per 1,000 | Routing |
|---|---|---|
RiskBypass | $3.00 | |
WTFSolve | $0.20 | |
Solverify | $0.50 |
Request Schema
| Field | Type | Required | Description |
|---|---|---|---|
clientKey* | string | Yes | Your API key. Create one in a workspace of the AnySolver dashboard. Example: |
task* | object | Yes | The task body. Required fields depend on the task type. See Tasks for per-task schemas. View task properties |
settings | object | No | Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes. View settings reference |
Task Object Properties
The task field accepts an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
type* | Yes | ||
websiteURL* | URL | Yes | Full URL of the page where the CAPTCHA is displayed. Example: |
perimeterxJsUrl* | string | Yes | URL of the PerimeterX Example: |
pxAppId* | string | Yes | PerimeterX app ID of the target site: Example: |
proxy* | string | object | Yes | Proxy the provider solves through, as a string or an object. See Proxy configuration. View proxy configurationExample: |
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "PerimeterXInvisibleToken",
"websiteURL": "https://www.walmart.com/",
"perimeterxJsUrl": "https://www.walmart.com/px/PXu6b0qd2S/init.js",
"pxAppId": "PXu6b0qd2S",
"proxy": "http://user:pass@1.2.3.4:8080"
}
}Optional fields are not guaranteed across providers
Response Schema
| Field | Type | Required | Description |
|---|---|---|---|
status* | Yes | Task status: "processing", "ready", or "failed". Example: | |
errorId* | Yes |
Example: | |
taskId | string | No | Unique identifier returned when the task was created. Example: |
errorCode | No | Machine-readable error code. Example: | |
errorDescription | string | No | Human-readable error message with resolution hints. Example: |
cost | number | No | Actual cost charged for this task in USD. Example: |
taskType | No | The type of CAPTCHA task to solve. Example: | |
provider | No | Provider that handled this task. While processing, the provider currently solving it. Example: | |
solution | object | No |
Solution Object Properties
The solution field contains an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
cookies* | Record<string, unknown> | Yes | PerimeterX cookies to set on the session, such as Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |
userAgent | string | No | User-Agent string used during solving. Example: |