> ## 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 v3

> Get high-score tokens for Google's reCAPTCHA v3 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": "RecaptchaV3"
      },
      "options": {
        "action": "submit",
        "enterprise": false
      }
    }'
  ```

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

  client = Scrapely(api_key="YOUR_API_KEY")

  task = client.google.RecaptchaV3(
      website_url="https://example.com",
      website_key="6LcQ3w4pAAAAABc...",
      action="submit",
      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 `"RecaptchaV3"`.                                                                  |

### options

| Field        | Type    | Default | Description                                          |
| ------------ | ------- | ------- | ---------------------------------------------------- |
| `action`     | string  | `null`  | The action name defined on the page. Max 100 chars.  |
| `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>
  reCAPTCHA v3 returns a score between 0.0 and 1.0. Scrapely targets a score of 0.7 or higher.
</Info>