Cookie usage notification

This site uses cookies. Cookies remember you, so we can provide you with personalized services. Read our privacy policy.

Logo of «GitHub»
  • We support API for «PHP» language
  • We support API for «Python» language
  • We support API for «Go» language
  • We support API for «Ruby» language
  • We support API for «C#» language
  • We support API for «Java» language
  • We support API for «JavaScript» language



Token-based method to bypass Tencent captcha.

Task types

  • TencentTaskProxyless - we use our own pool of proxies
  • TencentTask - we use your proxies

TencentTaskProxyless task type specification

Property Type Required Description
type String Yes Task type:
websiteURL String Yes The full URL of target web page where the captcha is loaded. We do not open the page, not a problem if it is available only for authenticated users
appId String Yes The value of appId parameter in the website source code.

TencentTask task type specification

TencentTask extends TencentTaskProxyless adding a set of proxy-related parameters listed below

Property Type Required Description
proxyType String Yes Proxy type:
proxyAddress String Yes Proxy IP address or hostname
proxyPort Integer Yes Proxy port
proxyLogin String No Login for basic authentication on the proxy
proxyPassword String No Password for basic authentication on the proxy

Request examples

Method: createTask
API endpoint:


    "clientKey": "YOUR_API_KEY",
    "task": {


    "clientKey": "YOUR_API_KEY",
    "task": {
        "proxyType": "http",
        "proxyAddress": "",
        "proxyPort": "8080",
        "proxyLogin": "user23",
        "proxyPassword": "p4$w0rd"

Response example

    "errorId": 0,
    "status": "ready",
    "solution": {
        "appid": "190014885",
        "ret": 0,
        "ticket": "tr0344YjJASGmJGtohyWS_y6tJKiqVPIdFgl87vWlVaQoueR8D6DH28go-i-VjeassM31SXO7D0*",
        "randstr": "@KVN"
    "cost": "0.00299",
    "ip": "",
    "createTime": 1692863536,
    "endTime": 1692863556,
    "solveCount": 1

Using the token

The token is passed to a callback function defined in 2nd argument of TencentCaptcha constructor call during the captcha initialization.

new TencentCaptcha(CaptchaAppId, callback, options);

This function is usually used to make a request to the website backend where the token is verified. You can execute the callback function passing the token as an argument or build a request to the backend using passing the token.

For example, if the captcha is initialized like this:

const myCallbackFunction = (token) {
    // verify the token
var captcha = new TencentCaptcha('190014885', myCallbackFunction, {});; 

You need to call:

let data = JSON.parse(res)

Where res is the JSON response from the API.