MTCaptcha

Attention!
Built-in proxies are used by default — their cost is already included in the service. You only need to specify your own proxies in cases where the website does not accept the token or access to the built-in services is restricted.

If you are using a proxy, please use a proxy with username and password authentication.

Request Parameters

Parameter	Type	Required	Description
`type`	String	Required	`MTCaptchaTask`
`websiteURL`	String	Required	The URL of the page where the captcha is solved.
`websiteKey`	String	Required	The MTcaptcha key, passed in the request parameters as `sk`.
`pageAction`	String	Optional	The `action` parameter is passed in the request as `act` and displayed when validating the token. Include it only if its value differs from the default %24. Example in HTML: `<script> var mtcaptchaConfig = { "sitekey": "MTPublic-abCDEFJAB", "action": "login" }; </script>`
`isInvisible`	Boolean	Optional	`true` if the captcha is invisible, i.e., has a hidden confirmation field. If bot suspicion occurs, an additional verification is triggered.
`userAgent`	String	Optional	Browser User-Agent. Pass only a valid UA from Windows OS.
`proxyType`	String	Optional	http - regular http/https proxy; https - try this option only if "http" doesn't work; socks4 - socks4 proxy; socks5 - socks5 proxy.
`proxyAddress`	String	Optional	IPv4/IPv6 proxy IP address. Not allowed: transparent proxies or local machine proxies.
`proxyPort`	Integer	Optional	Proxy port.
`proxyLogin`	String	Optional	Proxy server login.
`proxyPassword`	String	Optional	Proxy server password.

Create Task - Without Proxy

Request

POST https://captcha69.com/createTask
Content-Type: application/json

{
  "clientKey": "max1_YOUR_API_KEY",
  "task": {
    "type": "MTCaptchaTask",
    "websiteURL": "https://www.example.com",
    "websiteKey": "MTPublic-abCDEFJAB",
    "isInvisible": false,
    "pageAction": "login"
  }
}

Response

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

Create Task - With Proxy

Request

POST https://captcha69.com/createTask
Content-Type: application/json

{
  "clientKey": "max1_YOUR_API_KEY",
  "task": {
    "type": "MTCaptchaTask",
    "websiteURL": "https://www.example.com",
    "websiteKey": "MTPublic-abCDEFJAB",
    "isInvisible": false,
    "pageAction": "login",
    "proxyType": "http",
    "proxyAddress": "8.8.8.8",
    "proxyPort": 8080,
    "proxyLogin": "proxyLoginHere",
    "proxyPassword": "proxyPasswordHere"
  }
}

Response

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

Get Task Result

Use the getTaskResult method to get the solution for the MTCaptcha captcha.

Request

POST https://captcha69.com/getTaskResult
Content-Type: application/json

{
  "clientKey": "max1_YOUR_API_KEY",
  "taskId": 407533077
}

Response

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "solution": {
    "token": "v1(155506dc,c8c2e356,MTPublic-abCDEFJAB,70f03532a53...5FSDA**)"
  },
  "status": "ready"
}

Solution Properties

Property	Type	Description
`token`	String	The MTCaptcha solution token.

How to Find CAPTCHA Parameters

websiteKey

This parameter can be found in the Network tab of Developer Tools. Look for requests starting, for example, with getchallenge.json — the sk parameter corresponds to websiteKey.

pageAction

The same request contains the pageAction parameter: the needed value is passed as act. By default, it equals %24; if the value differs (e.g., ..&act=login&...), specify it when creating the task.