🎉New: Nstbrowser and Scrapeless Announce Strategic Integration, with Browser Labs R&D Center Launched🎉
Billing and Errors
Billing Rules
Common Error Codes
| Error code | Description | Recommended action |
|---|---|---|
CAPTCHA_INVALID_PARAMETERS | The CAPTCHA configuration is incomplete or invalid. | Send the complete captchaSolver object with boolean values. |
CAPTCHA_PLAN_NOT_CONFIGURED | CAPTCHA Solver is not available in the current plan. | Contact the workspace owner or use a plan with CAPTCHA Solver enabled. |
CAPTCHA_PROFILE_DISABLED | CAPTCHA Solver is disabled for the current Profile. | Enable it in the Profile, Group or runtime configuration and restart the browser. |
CAPTCHA_TYPE_DISABLED | The detected CAPTCHA type is disabled. | Enable that type and restart the browser. |
CAPTCHA_PROFILE_FORBIDDEN | The API user cannot access the Profile or its Team. | Verify the API key, Team and Profile permissions. |
CAPTCHA_PROFILE_NOT_FOUND | The Profile is unavailable or was deleted. | Verify the Profile ID and start a valid Profile. |
CAPTCHA_INSUFFICIENT_BALANCE | The account does not have enough credits. | Add credits before retrying. |
CAPTCHA_RATE_LIMITED | Too many CAPTCHA tasks were created in a short period. | Retry with backoff. |
CAPTCHA_PROVIDER_UNAVAILABLE | The upstream solving service is temporarily unavailable. | Continue with native verification or retry later. |
CAPTCHA_TASK_TIMEOUT | Automatic solving did not complete before the timeout. | Continue with native verification or retry the workflow. |
CAPTCHA_RESULT_NOT_APPLIED | A result was returned but could not be applied to the page. | Check the page state and complete verification manually if necessary. |
CAPTCHA_RUNTIME_UNAVAILABLE | The extension runtime is unavailable. | Stop and restart the Profile. |
CAPTCHA_VERSION_MISMATCH | The extension update is incomplete. | Update Nstbrowser and restart the Profile. |
ERROR_INVALID_TASK_DATA | The website CAPTCHA configuration is not supported. | Use native verification. |
ERROR_CAPTCHA_UNSOLVABLE | The provider could not solve the challenge. | Retry or use native verification. |
ERROR_TASK_TIMEOUT | The upstream CAPTCHA task timed out. | Retry or use native verification. |
Error Handling
/api/agent/captcha-solver/* or /api/v1/captcha-solver/* endpoints directly. They are reserved for the built-in extension and are not public CAPTCHA APIs.