Friendly Captcha

Friendly Captcha: parameters, request, response and the 2Captcha method of FriendlyCaptchaTaskProxyless and FriendlyCaptchaTask.

On this page

Rules
Parameters
Request
Response
2Captcha in.php

Friendly Captcha: the widget with a site key (v1 or v2). The answer is the token the widget puts into its frc-captcha-solution field.

Status	coming soon
Type codes	`FriendlyCaptchaTaskProxyless` — without a proxy; `FriendlyCaptchaTask` — with your proxy
Proxy	optional: the second code takes your proxy
Also accepted as	`FriendlyCaptchaTaskProxyLess`
Price	set when the type is switched on — see pricing

Rules#

The proxy code solves through your proxy, so the answer is issued for your IP address. See Proxies.

Parameters#

Fields of the task object in createTask:

ParameterDescription

type stringrequired: Task type: FriendlyCaptchaTaskProxyless, FriendlyCaptchaTask.
websiteURL stringrequired: Full address of the page with the captcha: http(s), up to 2048 characters, a public site.
websiteKey stringrequired: Site key of the widget on the page. Letters, digits and _ - . :, up to 128 characters.
version string: Version of the widget. One of v1, v2.
moduleScript string: URL of the widget script loaded with type=module. Absolute http(s) URL of a public site, up to 2048 characters.
nomoduleScript string: URL of the widget script loaded with nomodule. Absolute http(s) URL of a public site, up to 2048 characters.
userAgent string: User-Agent of the browser that will use the answer, up to 512 characters.
proxyType string: http (default), https, socks4 or socks5.
proxyAddress stringfor proxy types: IP address or host name of the proxy. Private and local addresses are rejected.
proxyPort integerfor proxy types: Proxy port, 1–65535.
proxyLogin string: Proxy login, up to 256 characters. Stored encrypted.
proxyPassword string: Proxy password, up to 256 characters. Stored encrypted.

Request#

A FriendlyCaptchaTaskProxyless task:

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "FriendlyCaptchaTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "SITE-KEY-1234"
  }
}

Response#

getTaskResult once the task is solved:

getTaskResult

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "TOKEN_eyJhbGciOiJIUzI1NiJ9…",
    "userAgent": ""
  },
  "cost": "0.001500",
  "ip": "198.51.100.7",
  "createTime": 1793370000,
  "endTime": 1793370012,
  "solveCount": 1
}

2Captcha in.php#

The same task through the 2Captcha API: method=friendly_captcha, parameters → task fields:

in.php	task
`sitekey`	`websiteKey`
`pageurl`	`websiteURL`
`version`	`version`
`module_script`	`moduleScript`
`nomodule_script`	`nomoduleScript`

res.php returns token of the solution as text (OK|…), or in request with json=1.