HCaptchaTask : hCaptcha puzzle solving

The object contains data for hCaptcha solving task. To provide solid universality for solving this type of task we have reproduce every piece of environment used for an automation task you plan to complete. This includes:

proxy access
browser's user-agent
(optionally) cookies

This approach will eliminate all possible obstacles which might implement in the future.

This type of captcha might be solved a bit longer than usual image captcha, but this issue is compensated by the fact that g-captcha-response value we send to you is valid for the next 60 seconds after we solves your hCaptcha.

Attention!

hCaptcha seems to have limit of solved tasks from one IP, about 3 items per 12 hours. Take this into account when you build solving process through your proxy.

Attention!

Proxies with IP authorization are not yet supported.

Object structure

Property	Type	Required	Default value
type	String	Yes	HCaptchaTask
websiteURL	String	Yes	Address of a webpage with hCaptcha
websiteKey	String	Yes	hCaptcha website key.
isInvisible	Bool	No	Use true for invisible version of hcaptcha
proxyType	String	Yes	Type of the proxy http - usual http/https proxy https - try this only if "http" doesn't work (required by some custom proxy servers) socks4 - socks4 proxy socks5 - socks5 proxy
proxyAddress	String	Yes	Proxy IP address IPv4/IPv6. Not allowed to use: host names instead of IPs transparent proxies (where client IP is visible) proxies from local networks (192.., 10.., 127...)
proxyPort	Integer	Yes	Proxy port
proxyLogin	String	No	Login for proxy which requires authorizaiton (basic)
proxyPassword	String	No	Proxy password
cookies	String	No	Additional cookies which we must use during interaction with target page. Format: cookiename1=cookievalue1; cookiename2=cookievalue2

Request example:

Address https://capkill.com/api/createTask

JSON with no errors

{
    "clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
    "task":
    {
        "type":"HCaptchaTask",
        "websiteURL":"https://accounts.hcaptcha.com/demo",
        "websiteKey":"a5f74b19-9e45-40e0-b45d-47ff91b7a6c2",
        "proxyType":"http",
        "proxyAddress":"8.8.8.8",
        "proxyPort":8080,
        "proxyLogin":"proxyLoginHere",
        "proxyPassword":"proxyPasswordHere"
    }
}

Response example:

JSON with no errors

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

Get Result:

Use the method getTaskResult to request an answer for hCaptcha. You will get a response within a 10 - 80 secs period depending on service workload.

Property	Type	Description
gRecaptchaResponse	String	Hash which should be inserted into hCaptcha submit form on target website.
userAgent	String	During submitting, you should use the same User Agent with which hCaptcha was solved.
respKey	String	The result of the "window.hcaptcha.getRespKey()" function when available. Some sites use this value for additional verification.

Example:

JSON with no errors

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "gRecaptchaResponse": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.hKdwYXNza2V5xQb9JvlblBqjTdKpourvlRNpOZLvJb0yJRmsXVFVjyxFWlL1wdYBXaPyFtnxwy2ukbMgwWn62-cjSc98Iw2XIPYWg5MNDKS4_7tBIhjY0PienoKy1...",
        "respKey": "E0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJkYXRhIjoidjQ3RjlqZGFYTllFQXlZZFYyRTlaWlBVQUdLaFpPakpRNjBXRTljVW40VnY3NnhuN2V3R0wwVWd1MW1Wai90WEdoYmt5a2NqVGlGdWpsSlpmVjcza...",
        "userAgent": "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36"
    }
}