MtCaptchaToken
Solve an MTCaptcha widget through your own proxy and get the verified token to submit with your form. With the request schema, an example and provider prices.
MtCaptchaToken solves an MTCaptcha widget through your proxy and returns the verified token to submit with your form. It takes the same parameters as MtCaptchaTokenProxyLess: find them as described in Find websiteKey and Optional parameters, and submit the token as described in Use the token.
Use MtCaptchaTokenProxyLess when the site does not validate the token against the address that submits it.
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. Use the same proxy for the request that submits the token.
Check Provider stats for live success rates and solve times before you pick a provider.
Supported Providers
| Provider | Price per 1,000 | Routing |
|---|---|---|
CapSolver | $3.00 | |
2Captcha | $1.45 | |
CapMonster | $1.50 | |
SolveCaptcha | $1.45 |
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: |
websiteKey* | string | Yes | The MTCaptcha sitekey, starting with Example: |
proxy* | string | object | Yes | Proxy the provider solves through, as a string or an object. See Proxy configuration. View proxy configurationExample: |
pageAction | string | No | The action value from the widget configuration (the Example: |
isInvisible | boolean | No | Set true when the widget is invisible, meaning it has a hidden confirmation field. MTCaptcha may then run an extra verification if it suspects a bot. Only CapMonster accepts it. Example: |
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "MtCaptchaToken",
"websiteURL": "https://service.mtcaptcha.com/mtcv1/demo/index.html",
"websiteKey": "MTPublic-DemoKey9M",
"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 |
|---|---|---|---|
token* | string | Yes | The solved CAPTCHA token to submit with your form. Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |