Skip to main content
Are you experiencing issues obtaining the token?
Contact support

Yidun - NECaptcha

View full price

Warning!

This task will be executed using our proxy servers.

Request Parameters​

type<string>required

YidunTask

websiteURL<string>required

Full URL of the page containing the CAPTCHA.

websiteKey<string>required

The value of the siteKey parameter found on the page (see the example below on how to find it).

userAgent<string>optional

Browser User-Agent.
You must provide a valid User-Agent from a Windows OS. The currently recommended one is: userAgentPlaceholder

proxyType<string>optional

http – standard HTTP/HTTPS proxy;
https – try this only if "http" doesn't work (required for some custom proxies);
socks4 – SOCKS4 proxy;
socks5 – SOCKS5 proxy.

proxyAddress<string>optional

Proxy IP address (IPv4/IPv6). The following are not allowed:

  • using hostnames;
  • using transparent proxies (where the client IP is visible);
  • using proxies from local machines.

proxyPort<integer>optional

Proxy port.

proxyLogin<string>optional

Proxy server login.

proxyPassword<string>optional

Proxy server password.

How to Get websiteURL and websiteKey​

Open the Developer Tools, activate the captcha, go to the Network tab, and find the request that starts with get?referer= or check?referer=. The value of referer is the websiteURL.

Sometimes the referer in the URL is encoded, for example: https%3A%2F%2Fid.example.com%2F. To get a readable address, you need to decode it, for example, using the browser console:

The value of id is the websiteKey.

Create Task Method​

POST
https://api.capmonster.cloud/createTask

Request

{
  "clientKey": "API_KEY",
  "task": {
    "type": "YidunTask",
    "websiteURL": "https://www.example.com",
    "websiteKey": "6cw0f0485d5d46auacf9b735d20218a5",
    "userAgent": "userAgentPlaceholder"
  }
}

Response

{
  "errorId": 0,
  "taskId": 407533077
}

Get Task Result Method​

Use the getTaskResult method to retrieve the solution for the Yidun CAPTCHA.

POST
https://api.capmonster.cloud/getTaskResult

Request

{
  "clientKey": "API_KEY",
  "taskId": 407533077
}

Response

{
  "errorId": 0,
  "errorCode": null,
  "errorDescription": null,
  "solution": {
    "token": "CN31_9AwsPmaYcJameP_09rA0vkVMQsPij...RXTlFJFc3"
  },
  "status": "ready"
}