NexusGuard Solver API

The Solverify NexusGuard Solver API creates a browser-based task for NexusGuard interstitial checkbox pages and returns the cookies issued after the challenge redirect in solution.cookies. Use this task type when the protected page shows the NexusGuard "I'm not a robot" checkbox and your follow-up request needs the same proxy and user-agent context.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Full URL of the target page protected by NexusGuard.
`useragent`	No	User-agent string to use for the browser session. Recommended when your follow-up request must match a specific client profile.
`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.

NexusGuard cookies are IP-bound. Use the same sticky proxy session for the solver task and for the request where you replay the returned cookies.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "nexusguard",
    "websiteURL": "https://example.com/",
    "useragent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "8080",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Create Response

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

Result Example

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "",
    "cookies": {
      "cookie_name": "cookie_value"
    },
    "useragent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
  },
  "errorCode": null,
  "errorDescription": null
}

The exact cookie names depend on the protected origin. Send all returned cookies with the same proxy and matching user-agent when making the follow-up request.

Timeout

NexusGuard tasks can run for up to about 90 seconds before timing out internally.

Next Steps

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