Friendly Captcha

Friendly Captcha is a privacy-focused CAPTCHA that uses proof-of-work puzzles instead of image recognition or behavioral analysis. It is commonly used on European websites due to its GDPR-compliant design. The challenge runs a computational puzzle in the user’s browser, and upon completion, generates a solution token that is submitted with the form. Solving Friendly Captcha through the API returns this token directly.

Supported Types

Type	Proxy Required	Description
FriendlyCaptchaToken	Yes	Solves the challenge using your proxy. Use when the target site validates the solver’s IP against the submitting IP.
FriendlyCaptchaTokenProxyLess	No	Solves the challenge without a proxy. Recommended for most use cases.

Parameters

Parameter	Type	Required	Description
type	string	Yes	FriendlyCaptchaToken or FriendlyCaptchaTokenProxyLess
websiteURL	string	Yes	The URL of the page containing the Friendly Captcha widget
websiteKey	string	Yes	The site key (puzzle endpoint key) found in the data-sitekey attribute of the Friendly Captcha widget element

Proxy Parameters

Required when using the FriendlyCaptchaToken type:

Parameter	Type	Required	Description
proxyType	string	Yes	http, socks4, or socks5
proxyAddress	string	Yes	Proxy IP or hostname
proxyPort	integer	Yes	Proxy port
proxyLogin	string	No	Proxy username
proxyPassword	string	No	Proxy password

Create Task Request

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "FriendlyCaptchaTokenProxyLess",
    "websiteURL": "https://example.com/signup",
    "websiteKey": "FCMGEMUD2KTDSQ5H"
  }
}

With proxy:

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "FriendlyCaptchaToken",
    "websiteURL": "https://example.com/signup",
    "websiteKey": "FCMGEMUD2KTDSQ5H",
    "proxyType": "http",
    "proxyAddress": "1.2.3.4",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass"
  }
}

Response

{
  "errorId": 0,
  "taskId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

Solution Object

{
  "token": "PUZZLE_SOLUTION_TOKEN_HERE..."
}

Field	Type	Description
token	string	The solved puzzle token to submit with the form

How to Use

1. Locate the Friendly Captcha widget on the target page. The site key is in the data-sitekey attribute of the .frc-captcha element.
2. Submit the task and poll for the solution.
3. Insert the returned token as the value of the .frc-captcha-solution hidden input field in the form.
4. Submit the form as normal. The server will validate the token against the Friendly Captcha API.

Tip

In the page HTML, look for an element like <div class="frc-captcha" data-sitekey="FCMGEMUD2KTDSQ5H"></div>. The data-sitekey value is what you pass as websiteKey.

Code Examples

Python

import requests
import time

API_KEY = "YOUR_API_KEY"

response = requests.post("https://api.ucaptcha.net/createTask", json={
    "clientKey": API_KEY,
    "task": {
        "type": "FriendlyCaptchaTokenProxyLess",
        "websiteURL": "https://example.com/signup",
        "websiteKey": "FCMGEMUD2KTDSQ5H"
    }
})
task_id = response.json()["taskId"]

while True:
    result = requests.post("https://api.ucaptcha.net/getTaskResult", json={
        "clientKey": API_KEY,
        "taskId": task_id
    }).json()
    if result["status"] == "ready":
        token = result["solution"]["token"]
        print("Solution:", token)

        # Submit the form with the token
        form_data = {
            "frc-captcha-solution": token,
            "email": "user@example.com"
        }
        response = requests.post("https://example.com/signup", data=form_data)
        print("Status:", response.status_code)
        break
    elif result["status"] == "failed":
        print("Error:", result.get("errorDescription"))
        break
    time.sleep(5)

JavaScript

const API_KEY = "YOUR_API_KEY";

const { taskId } = await fetch("https://api.ucaptcha.net/createTask", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    clientKey: API_KEY,
    task: {
      type: "FriendlyCaptchaTokenProxyLess",
      websiteURL: "https://example.com/signup",
      websiteKey: "FCMGEMUD2KTDSQ5H"
    }
  })
}).then(r => r.json());

while (true) {
  const result = await fetch("https://api.ucaptcha.net/getTaskResult", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ clientKey: API_KEY, taskId })
  }).then(r => r.json());

  if (result.status === "ready") {
    console.log("Solution:", result.solution.token);
    break;
  } else if (result.status === "failed") {
    console.error("Error:", result.errorDescription);
    break;
  }
  await new Promise(r => setTimeout(r, 5000));
}

cURL

# Create the task
curl -X POST https://api.ucaptcha.net/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "FriendlyCaptchaTokenProxyLess",
      "websiteURL": "https://example.com/signup",
      "websiteKey": "FCMGEMUD2KTDSQ5H"
    }
  }'

# Poll for the result (replace TASK_ID with the returned taskId)
curl -X POST https://api.ucaptcha.net/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "TASK_ID"
  }'

Provider Coverage

• 2Captcha
• Anti-Captcha

Aliases

No backward-compatible aliases. Use FriendlyCaptchaToken or FriendlyCaptchaTokenProxyLess directly.