SCRAPPEY CAPTCHA DOCS

reCAPTCHA v3 (ProxyLess): solving reCAPTCHA v3 (ProxyLess)

Command: recaptchav3

TIP Create the task with createTask method and get the result with getTaskResult method.

Already using Anti-Captcha/CapSolver style APIs? Switch provider URLs to https://captcha.scrappey.com and keep the same flow.

Pricing: 1 EUR / 1000 requests. Volume pricing gets cheaper the more you buy.

Create Task

Create a recognition task with the createTask method.

Task Object Structure

PropertiesTypeRequiredDescription
typeStringRequiredReCaptchaV3TaskProxyLess
websiteURLStringRequiredWeb address of the target page.
websiteKeyStringRequiredDomain public key / captcha sitekey.
pageActionStringOptionalreCAPTCHA v3 action value (recommended to match target page action).
isSessionBooleanOptionalSession mode hint for compatibility. Currently passed through only.
apiDomainStringOptionalCaptcha domain hint (google.com or recaptcha.net).

Example Request

POST https://captcha.scrappey.com/createTask
Host: captcha.scrappey.com
Content-Type: application/json

{
  "clientKey": "YOUR_SCRAPPEY_API_KEY",
  "task": {
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
    "websiteKey": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
    "pageAction": "examples/v3scores"
  }
}

Example Response

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "status": "idle",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Getting Results

Submit the returned taskId to get recognition results.

Example Request

POST https://captcha.scrappey.com/getTaskResult
Host: captcha.scrappey.com
Content-Type: application/json

{
  "clientKey": "YOUR_SCRAPPEY_API_KEY",
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Example Response

{
  "errorId": 0,
  "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006",
  "status": "ready",
  "errorCode": null,
  "errorDescription": null,
  "solution": {
    "userAgent": "Mozilla/5.0 ...",
    "createTime": 1671615324290,
    "gRecaptchaResponse": "3AHJ......"
  }
}

Use SDK Request (Node.js)

// npm install axios
import axios from "axios";

const baseURL = "https://captcha.scrappey.com";
const clientKey = process.env.SCRAPPEY_API_KEY;

const { data: created } = await axios.post(`${baseURL}/createTask`, {
  clientKey,
  task: {
  "type": "ReCaptchaV3TaskProxyLess",
  "websiteURL": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
  "websiteKey": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
  "pageAction": "examples/v3scores"
}
});

const taskId = created.taskId;

while (true) {
  await new Promise((r) => setTimeout(r, 1500));
  const { data: result } = await axios.post(`${baseURL}/getTaskResult`, {
    clientKey,
    taskId
  });

  if (result.status === "ready") {
    console.log("gRecaptchaResponse:", result.solution.gRecaptchaResponse);
    break;
  }

  if (result.status === "failed") {
    throw new Error(`${result.errorCode}: ${result.errorDescription}`);
  }
}