Friendly captcha solver

Token-based method for automated solving of Friendly Captcha.

The token received must be set as the value attribute of the input#cap_token element and/or passed to the callback function.

Important: To successfully use the received token, the captcha widget must not be loaded on the page. To do this, you need to abort request to /friendlycaptcha/...module.min.js on the page. When the captcha widget is already loaded on the page, there is a high probability that the received token will not work.

Method specification

Parameter	Type	Required	Description
key	String	Yes	your API key
method	String	Yes	friendly_captcha
sitekey	String	Yes	The value of data-apikey attribute of captcha's div element on page.
pageurl	String	Yes	Full URL of the page where you solve the captcha
version	String	No	Friendly Captcha version. v1 — Friendly Captcha V1. v2 — Friendly Captcha V2. Default: v1. See the official Friendly Captcha documentation for more details on version differences.
module_script	String	No	URL of the Friendly Captcha script with the type="module" attribute, found on the captcha page.
nomodule_script	String	No	URL of the Friendly Captcha script with the nomodule attribute, found on the captcha page.
proxy	String	No	Your proxy: login:[email protected]:3128 You can find more info about proxies here
proxytype	String	No	Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5
json	Number	No	Set to 1 to get the response as JSON. Default: 0
soft_id	Number	No	ID of software developer. Developers who integrated their software with our service get reward: 10% of spendings of their software users

Request example POST https://api.solvecaptcha.com/in.php

Friendly Captcha V1:

{
  "key": "YOUR_API_KEY",
  "method": "friendly_captcha",
  "sitekey": "7KXMD4TQ9PL8RW",
  "pageurl": "https://example.com",
  "version": "v1",
  "module_script": "https://cdn.example.com/static/js/friendly-challenge/@0.9.1/widget.module.min.js",
  "nomodule_script": "https://cdn.example.com/static/js/friendly-challenge/@0.9.1/widget.js",
  "json": 1
}

Friendly Captcha V2:

{
  "key": "YOUR_API_KEY",
  "method": "friendly_captcha",
  "sitekey": "7KXMD4TQ9PL8RW",
  "pageurl": "https://example.com",
  "version": "v2",
  "module_script": "https://cdn.example.com/v2/widget.module.min.js",
  "nomodule_script": "https://cdn.example.com/v2/widget.js",
  "json": 1
}

Request will return the id of your captcha. Use it to get the result.

Getting the result

Request example POST https://api.solvecaptcha.com/in.php

{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": "2112373961",
  "json": 1
}

Result example

{
  "status": 1,
  "request": "c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF",
}

Using the token

Use the returned token as a value for input with name = frc-captcha-solution, then submit it's parent form, for example:

document.querySelector('input.frc-captcha-solution').value = 'c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF';
document.querySelector('form').submit();

Please note, that form name can be customized with data-solution-field-name attribute, then you need to use the name set as the attribute's value.

If there's a callback function defined, you can call it passing the token as argument. For example, if data-callback="doneCallback" you should run it as:

doneCallback('c3e9a7d5f1b2486fae7c93d2ab41e8f0.Q7K2L...BBBBBB.BhEF');