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