Yidun (NetEase)

Yidun (also known as NECaptcha) is a CAPTCHA service developed by NetEase, widely deployed across Chinese websites and applications. It presents various challenge types including slider puzzles, click-based verification, and intelligent risk assessment. The uCaptcha API solves Yidun challenges and returns a verification token, with or without a proxy.

Supported Types

Type	Proxy	Description
YidunTokenProxyLess	No	Solve without proxy (recommended)
YidunToken	Yes	Solve using your proxy

Parameters

Parameter	Type	Required	Description
type	string	Yes	Task type from the table above
websiteURL	string	Yes	URL of the page with the Yidun challenge
websiteKey	string	Yes	Yidun captcha ID (the captchaId parameter)

Proxy Parameters

Required when using the YidunToken task 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": "YidunTokenProxyLess",
    "websiteURL": "https://example.cn/login",
    "websiteKey": "c1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6"
  }
}

Response

{
  "errorId": 0,
  "taskId": "abc-123-def"
}

Solution Object

{
  "token": "NECaptcha_validate_a1b2c3d4e5f6...verification"
}

Field	Type	Description
token	string	The Yidun / NECaptcha verification token to submit with the form

How to Use

Once you receive the token value from the solution:

1. Form submission — Set the NECaptcha validate token in the hidden verification field and submit the form.
2. API request — Include the token in the NECaptchaValidate parameter when calling the target server’s login or verification endpoint.

Tip

Yidun challenges are commonly found on NetEase-powered sites (163.com, nie.netease.com) and many Chinese e-commerce and gaming platforms. The websiteKey is typically the captchaId value found in the page’s NECaptcha initialization script.

Code Examples

Python

import requests
import time

API_KEY = "YOUR_API_KEY"

# Create task
response = requests.post("https://api.ucaptcha.net/createTask", json={
    "clientKey": API_KEY,
    "task": {
        "type": "YidunTokenProxyLess",
        "websiteURL": "https://example.cn/login",
        "websiteKey": "c1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6"
    }
})
task_id = response.json()["taskId"]

# Poll for result
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("Token:", token)
        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: "YidunTokenProxyLess",
      websiteURL: "https://example.cn/login",
      websiteKey: "c1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6"
    }
  })
}).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("Token:", result.solution.token);
    break;
  } else if (result.status === "failed") {
    console.error("Error:", result.errorDescription);
    break;
  }

  await new Promise(r => setTimeout(r, 5000));
}

cURL

# Create task
curl -X POST https://api.ucaptcha.net/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "YidunTokenProxyLess",
      "websiteURL": "https://example.cn/login",
      "websiteKey": "c1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6"
    }
  }'

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

Provider Coverage

• CapMonster

Aliases

The following legacy type names are also accepted for backward compatibility:

• YidunTask
• YidunTaskProxyless
• NECaptchaToken
• NECaptchaTokenProxyLess