ComplexImageTask Recaptcha: Google captcha solution

The object contains data about the task for solving ReCaptcha2 from Google.

Object structure

Parameter	Type	Required	Possible values	Description
type	String	yes	ComplexImageTask	Specifies the task object type
class	String	yes	recaptcha	Specifies the task object class
imageUrls	Array	yes (if imagesBase64 is not filled)	[ “https://i.postimg.cc/yYjg75Kv/img1.jpg” ]	Single image 4x4, 3x3 or a new 1x1 captcha part (in an array).
imagesBase64	Array	yes (if imageUrls is not filled)	[ “/9j/4AAQSkZJRgABAQEAAAAAAAD…” ]	Single image 4x4, 3x3 or a new 1x1 captcha part in base64 format (in an array).
metadata.Grid	String	yes	4x4, 3x3, 1x1	Image grid size
metadata.TaskDefinition	String	yes (if metadata.Task is not filled)	`/m/015qff` and others	Technical value that defines the task type How to get TaskDefinition The data can be found in responses to "/recaptcha/{recaptchaApi}/reload" or "/recaptcha/{recaptchaApi}/userverify" requests, where recaptchaApi is "enterprise" or "api2" depending on the Recaptcha type. The response contains json, in which one can take a list of TaskDefinitions for loaded captchas.
metadata.Task	String	yes (if metadata.TaskDefinition is not filled)	`Click on traffic lights` and others	Task text (in English)
userAgent	String	no	-	The browser User-Agent to use when loading images if links were passed in imageUrls. It is required to use a modern browser signature, otherwise Google will return an error asking for a browser update.
websiteURL	String	no	-	URL of the page where the captcha is solved

Request example

URL https://api.capmonster.cloud/createTask

{
    "clientKey":"dce6bcbb1a728ea8d871de6d169a2057",
    "task": {
        "type": "ComplexImageTask",
        "class": "recaptcha",
        "imageUrls":[ "https://i.postimg.cc/yYjg75Kv/payloadtraffic.jpg" ],
        "metadata": {
            "Task": "Click on traffic lights",
            "Grid": "3x3",
            "TaskDefinition": "/m/015qff"
        },
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36.",
        "websiteUrl": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=middle"
    }
}

Response example

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

Getting a result

Use the getTaskResult method to get the captcha solution. Depending on the system load, you will receive a response after a time ranging from 300ms to 6s.

Property	Type	Description
answer	Array	List with boolean values, "true" means that you need to click on the image corresponding to this position

Example:

{
    "errorId":0,
    "status":"ready",
    "solution":
    {
        "answer": [ false, false, false, false, true, false, false, false, false ]
    }
}

Pricing:

	Name	Cost per 1000 images, $	Cost per 1000 new dynamic images, $

	Name	Cost per 1000 images, $	Cost per 1000 new dynamic images, $
1	reCAPTCHA 2 (3*3)	0,2	0,04
2	reCAPTCHA 2 (4*4)	0,1	not applicable