Altcha CAPTCHA

Token-based method for automated solving of Altcha.

Token-based method requires challengeurl and challengeJSON parameter, as well as proxy (not required).

Task types

AltchaTaskProxyless - we use our own proxies pool to load and solve the captcha
AltchaTask - we use your proxies

Property	Type	Required	Description
type	String	Yes	Task type: AltchaTaskProxyless AltchaTask
websiteURL	String	Yes	The full URL of target web page where the captcha is loaded.
challengeURL	String	Yes	The value of the `src` parameter for the `iframe` element containing the captcha on the page.
challengeJSON	String	Yes	The contents of the file from the 'challenge_url' parameter

AltchaTask type specification

AltchaTask extends AltchaTaskProxyless adding a set of proxy-related parameters listed below

Property	Type	Required	Description
proxyType	String	Yes	Proxy type: http socks4 socks5
proxyAddress	String	Yes	Proxy IP address or hostname
proxyPort	Integer	Yes	Proxy port
proxyLogin	String	No	Login for basic authentication on the proxy
proxyPassword	String	No	Password for basic authentication on the proxy

Request example

Method: createTask
API endpoint: https://api.2captcha.com/createTask

AltchaTaskProxyless

json Copy

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "AltchaTask",
    "websiteURL": "https://site.com/",
    "challengeURL": "hhttps://.../captcha/api/altcha/challenge",
    "challengeJSON": "hhttps://.../captcha/api/altcha/challenge",
  }
}

AltchaTask

json Copy

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "AltchaTask",
    "websiteURL": "https://site.com/",
    "challengeURL": "hhttps://.../captcha/api/altcha/challenge",
    "challengeJSON": "hhttps://.../captcha/api/altcha/challenge",
    "proxyType":"http",
    "proxyAddress":"1.2.3.4",
    "proxyPort": "8080",
    "proxyLogin":"user23",
    "proxyPassword":"p4$w0rd"
  }
}

Response example

Method: getTaskResult
API endpoint: https://api.2captcha.com/getTaskResult

json Copy

{
    "cost": "0.0012",
    "createTime": 1754563182,
    "endTime": 1754563190,
    "errorId": 0,
    "ip": "46.53.232.76",
    "solution":
    {
        "token":"eyJhbGdvcml0aG0iOiJTSEEtMjU2IiwiY2hhbGxlbmdlIjoiZWFiOTE3NjRkM2Y5ZDBjMGU4ZmR......."
    },
    "solveCount": 1,
    "status": "ready"
}

Use the token to interact with the target website.