reCAPTCHA v3 - Scrapely

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
    }
  }'

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)

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

{
  "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"
}

reCAPTCHA v3 returns a score between 0.0 and 1.0. Scrapely targets a score of 0.7 or higher.