Skip to Content
AnySolver logo
AnySolver
Token

CutCaptchaToken

Solve CutCaptcha through your own proxy from the misery key and API key and get the token for the form. With the schema, an example and provider prices.

CutCaptchaToken solves CutCaptcha through your proxy and returns the token the page expects. CutCaptcha is a CAPTCHA widget that renders inside an iframe. The task takes the page URL, the misery key and the API key.

Use CutCaptchaTokenProxyLess when the site accepts a token solved from another address.

Proxy

task.proxy is required on this task type, and the provider solves from that address. Send the proxy you use for your own requests to the site, and keep one IP for the whole solve: see Keep the same IP for the whole solve.

Find the parameters

  • miseryKey is the value of the CUTCAPTCHA_MISERY_KEY variable defined on the page. Search the page source or the Console for CUTCAPTCHA_MISERY_KEY.
  • apiKey is the data-apikey attribute of the CAPTCHA iframe's body. It is also the name of the JavaScript file the page includes for the widget.
  • websiteURL is the full URL of the page that shows the widget.

Use the token

Set the solution token as the value of the input with the id cap_token, then submit the parent form. If the page defines a callback function, such as capResponseCallback, you can call it with the token instead.

If the site rejects the token, check that the proxy kept one IP for the whole solve, then that miseryKey and apiKey come from the page that shows the widget.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
2Captcha
$1.45
SolveCaptcha
$1.45

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

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:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://example.cc/foo/bar.html

miseryKey*
stringYes

Value of the CUTCAPTCHA_MISERY_KEY variable defined on the page.

Example: a1488b66da00bf332a1488993a5443c79047e752

apiKey*
stringYes

CutCaptcha API key: the data-apikey attribute of the iframe body, which is also the name of the JavaScript file the page includes.

Example: SAb83IIB

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "CutCaptchaToken",
        "websiteURL": "https://example.cc/foo/bar.html",
        "miseryKey": "a1488b66da00bf332a1488993a5443c79047e752",
        "apiKey": "SAb83IIB",
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
token*
stringYes

The solved CAPTCHA token to submit with your form.

Example: BazM23cpFUUyAAAdqPwNEDZx0REtH3ss

raw*
Record<string, unknown>Yes

Raw provider response data for advanced use cases.