> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapely.io/llms.txt
> Use this file to discover all available pages before exploring further.

# reCAPTCHA v2

> Solve Google's reCAPTCHA v2 checkbox and invisible challenges.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.scrapely.io/v2/tasks/create \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_API_KEY" \
    -d '{
      "captcha": {
        "websiteURL": "https://example.com",
        "websiteKey": "6LcQ3w4pAAAAABc...",
        "type": "RecaptchaV2"
      },
      "options": {
        "invisible": false,
        "enterprise": false
      }
    }'
  ```

  ```python Python SDK theme={null}
  from scrapely import Scrapely

  client = Scrapely(api_key="YOUR_API_KEY")

  task = client.google.RecaptchaV2(
      website_url="https://example.com",
      website_key="6LcQ3w4pAAAAABc...",
      invisible=False,
      enterprise=False
  )

  print(task.result.solution)
  ```
</CodeGroup>

## Request fields

### captcha

| Field        | Type   | Required | Description                                                                               |
| ------------ | ------ | -------- | ----------------------------------------------------------------------------------------- |
| `websiteURL` | string | Yes      | URL of the page with the CAPTCHA. Must start with `http://` or `https://`. Max 254 chars. |
| `websiteKey` | string | Yes      | The sitekey from the page. Min 10, max 200 chars.                                         |
| `type`       | string | Yes      | Must be `"RecaptchaV2"`.                                                                  |

### options

| Field        | Type    | Default | Description                                          |
| ------------ | ------- | ------- | ---------------------------------------------------- |
| `invisible`  | boolean | `false` | Set to `true` for invisible reCAPTCHA v2.            |
| `enterprise` | boolean | `false` | Set to `true` if the site uses reCAPTCHA Enterprise. |

### proxy (optional)

| Field      | Type    | Required | Description                           |
| ---------- | ------- | -------- | ------------------------------------- |
| `scheme`   | string  | Yes      | Proxy scheme (e.g. `http`, `socks5`). |
| `host`     | string  | Yes      | Proxy host.                           |
| `port`     | integer | Yes      | Proxy port.                           |
| `username` | string  | No       | Proxy username.                       |
| `password` | string  | No       | Required if `username` is provided.   |

## Response

```json theme={null}
{
  "success": true,
  "task_id": "52989a12-a43c-4bf9-ba1d-8ab1e1509169",
  "status": "completed",
  "created_at": "2026-04-06T10:54:56.652354+00:00",
  "result": {
    "solution": "03AGdBq24PBCbwiDRaS..."
  },
  "completed_at": "2026-04-06T10:55:08.312452+00:00"
}
```

<Info>
  The `solution` token is valid for approximately 2 minutes. Submit it to the target site immediately.
</Info>