Skip to main content
reCAPTCHA-v2, also known as the I’M NOT A ROBOT captcha, is one of the most common image-based verification systems.
reCAPTCHA v2 image challenge example — Select all images with cars

1. Create task

Request

Body Parameters

The image must be resized to a standard resolution (100x100, 300x300, or 450x450) so the service can identify the image type.

Response

  • errorId = 0 and taskId → success
  • errorId = 1 and errorCode → failure (see Error codes)

2. Retrieve the result

Request

Response

  • errorId = 0 & status = "ready" → read the result in solution.objects (positions of tiles to click)
  • errorId = 0 & status = "processing" → still processing, wait 2 seconds and retry
  • errorId = 1 → failure, look up errorCode in the Error codes table