reCAPTCHA v3 (With Proxy): solving reCAPTCHA v3 (With Proxy)

Command: recaptchav3

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

DANGER ReCaptchaV3Task requires your own proxy.

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

Properties	Type	Required	Description
`type`	String	Required	ReCaptchaV3Task
`websiteURL`	String	Required	Web address of the target page.
`websiteKey`	String	Required	Domain public key / captcha sitekey.
`proxy`	String	Required	Your proxy string. Example: http://user:pass@host:port
`pageAction`	String	Optional	reCAPTCHA v3 action value (recommended to match target page action).
`isSession`	Boolean	Optional	Session mode hint for compatibility. Currently passed through only.
`apiDomain`	String	Optional	Captcha 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": "ReCaptchaV3Task",
    "websiteURL": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
    "websiteKey": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
    "pageAction": "examples/v3scores",
    "proxy": "http://user:pass@host:port"
  }
}

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": "ReCaptchaV3Task",
  "websiteURL": "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php",
  "websiteKey": "6LdKlZEpAAAAAAOQjzC2v_d36tWxCl6dWsozdSy9",
  "pageAction": "examples/v3scores",
  "proxy": "http://user:pass@host:port"
}
});

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}`);
  }
}