Cookie usage notification

This site uses cookies. Cookies remember you, so we can provide you with personalized services. Read our privacy policy.

Logo of «GitHub»
  • We support API for «PHP» language
  • We support API for «Python» language
  • We support API for «Go» language
  • We support API for «Ruby» language
  • We support API for «C#» language
  • We support API for «Java» language
  • We support API for «JavaScript» language

Capy Puzzle CAPTCHA

Capy widget

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

{
    "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

// 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

cap := api2captcha.Capy{
  SiteKey: "PUZZLE_Abc1dEFghIJKLM2no34P56q7rStu8v",
  Url: "https://www.mysite.com/captcha/",
}
req := cap.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/'
})