Skip to Content
AnySolver logo
AnySolver
Token

FriendlyCaptchaToken

Solve Friendly Captcha v1 and v2 through your proxy from the sitekey and widget script URLs. Shows the request schema, an example and provider prices.

FriendlyCaptchaToken solves Friendly Captcha through your proxy and returns the token the form expects. Friendly Captcha is a proof-of-work CAPTCHA: the widget solves a puzzle in the visitor's browser and the form submits the result. The task takes the page URL, the sitekey and the widget script URLs.

Use this task when the site checks that the solve came from the same IP as your own requests. Otherwise use FriendlyCaptchaTokenProxyLess, which takes the same parameters without a proxy.

Find the parameters

  • websiteKey is the data-sitekey attribute of the div with the frc-captcha class. Friendly Captcha sitekeys start with FC.
  • version is v1 for the friendly-challenge widget and v2 for the @friendlycaptcha/sdk widget. Search the page source for friendly-challenge or @friendlycaptcha/sdk to tell them apart. The default is v1.
  • moduleScript is the src of the Friendly Captcha script tag with type="module". Friendly Captcha documents the standard URLs as https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.18/widget.module.min.js for v1 and https://cdn.jsdelivr.net/npm/@friendlycaptcha/sdk@1.1.3/site.min.js for v2. Pages can host the file on their own domain, so copy the URL from the page.
  • nomoduleScript is optional. It is the src of the script tag with the nomodule attribute (widget.min.js on v1, site.compat.min.js on v2).

Send the proxy

task.proxy is required on this task type, and the provider solves from that address. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve.

Use the token

On v1, set solution.token as the value of the form field named frc-captcha-solution. On v2, the field is frc-captcha-response. A site can rename the field with the data-solution-field-name attribute, so confirm it by submitting the form once in a browser with the DevTools Network tab open. If the widget element has a data-callback function, you can call it with the token instead.

Load the page without the Friendly Captcha widget script when you apply the token, for example by blocking the request to the module script. A widget that is already running can overwrite or reject the value. If the token is rejected, check that the proxy kept one IP for the whole solve, then that websiteKey and websiteURL come from the page that shows the widget.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
2Captcha
$1.45
Anti-Captcha
$2.00
CapMonster
$1.50
SolveCaptcha
$1.45
SCTG
$0.40

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes.

View settings reference

Task Object Properties

The task field accepts an object with the following properties:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://example.com/signup

websiteKey*
stringYes

The data-sitekey attribute of the frc-captcha element on the page. Friendly Captcha sitekeys start with FC.

Example: FCMGD8BOO9CFF3RA

moduleScript*
stringYes

URL of the script the page loads with type="module": friendly-challenge@X.Y.Z/widget.module.min.js on v1, @friendlycaptcha/sdk@X.Y.Z/site.min.js on v2. The page may serve it from its own domain.

Example: https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.18/widget.module.min.js

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

version
No

Friendly Captcha major version used on the page: v1 (friendly-challenge widget) or v2 (@friendlycaptcha/sdk). Defaults to v1.

Example: v1

nomoduleScript
stringNo

URL of the script the page loads with the nomodule attribute: widget.min.js on v1, site.compat.min.js on v2.

Example: https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.18/widget.min.js

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "FriendlyCaptchaToken",
        "websiteURL": "https://example.com/signup",
        "websiteKey": "FCMGD8BOO9CFF3RA",
        "moduleScript": "https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.18/widget.module.min.js",
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
token*
stringYes

Solved token. Submit it as frc-captcha-solution on v1 and frc-captcha-response on v2.

Example: f8b10f4ad796484bae963b1ebe3ce2bb.ZXL8Z...AAAAAA.AgAD

raw*
Record<string, unknown>Yes

Raw provider response data for advanced use cases.

userAgent
stringNo

User-Agent string used during solving.