Capy Puzzle CAPTCHA

Token-based method for automated solving of Capy Puzzle Captcha.

Task types

CapyTaskProxyless - we use our own pool of proxies
CapyTask - we use your proxies

CapyTaskProxyless task type specification

Property	Type	Required	Description
type	String	Yes	Task type: CapyTaskProxyless CapyTask
websiteURL	String	Yes	The full URL of target web page where the captcha is loaded. We do not open the page, not a problem if it is available only for authenticated users
websiteKey	String	Yes	Capy Puzzle Captcha `captchakey`.
userAgent	String	No	User-Agent of your browser will be used to load the captcha. Use only modern browser's User-Agents

CapyTask task type specification

CapyTask extends CapyTaskProxyless 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 examples

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

CapyTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CapyTask",
    "websiteURL": "https://example.com/",
    "websiteKey": "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": "8080",
    "proxyLogin": "user23",
    "proxyPassword": "p4$w0rd"
  }
}

CapyTaskProxyless

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "CapyTaskProxyless",
    "websiteURL": "https://example.com/",
    "websiteKey": "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v"
  }
}

Response example

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

{
    "errorId": 0,
    "status": "ready",
    "solution": {
        "captchakey": "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
        "challengekey": "qHAPtn68KTnXFM8VQ3mtYRtmy3cSKuHJ",
        "answer": "0xax8ex0xax84x0xkx7qx0xux7gx0xx42x0x3ox42x0x3ox4cx",
        "respKey": ""
    },
    "cost": "0.00299",
    "ip": "1.2.3.4",
    "createTime": 1692863536,
    "endTime": 1692863556,
    "solveCount": 1
}

Code examples

PHP
Python
C#
Java
Go
Ruby

// https://github.com/2captcha/2captcha-php
$result = $solver->capy([
    'sitekey' => 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
    'url'     => 'http://mysite.com/',
    'api_server' => 'https://jp.api.capy.me/',
]);

# https://github.com/2captcha/2captcha-python

result = solver.capy(sitekey='PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
                    url='http://mysite.com/',
                    api_server='https://jp.api.capy.me/',
                    param1=..., ...)

// https://github.com/2captcha/2captcha-csharp

Capy captcha = new Capy();
captcha.SetSiteKey("PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v");
captcha.SetUrl("https://www.mysite.com/captcha/");
captcha.SetProxy("HTTPS", "login:password@IP_address:PORT");

// https://github.com/2captcha/2captcha-java
Capy captcha = new Capy();
captcha.setSiteKey("PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v");
captcha.setUrl("https://www.mysite.com/captcha/");
captcha.setProxy("HTTPS", "login:password@IP_address:PORT");

// https://github.com/2captcha/2captcha-go

captcha := api2captcha.Capy{
  SiteKey: "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
  Url: "https://www.mysite.com/captcha/",
}
req := captcha.ToRequest()
req.SetProxy("HTTPS", "login:password@IP_address:PORT")
code, err := client.Solve(req)

# https://github.com/2captcha/2captcha-ruby

result = client.capy({
  sitekey: 'PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v',
  pageurl: 'http://mysite.com/',
  api_server: 'https://jp.api.capy.me/'
})