Tencent Slider Captcha Solver API 🚀

An advanced Playwright and Computer Vision (OpenCV) based Actor that seamlessly bypasses Tencent Jigsaw Slider Captchas on any website.

The Actor automatically navigates to your target URL, waits for the Tencent Captcha iframe to appear, intercepts the puzzle piece and background images in real-time, calculates the exact pixel offset using OpenCV template matching, and simulates a human-like drag motion to bypass the security check.

Good for

• Scraping data from websites protected by Tencent Captcha (e.g., Asian e-commerce, logistics trackers).
• Automating logins or form submissions that require sliding a puzzle piece.
• Generating authenticated Session Cookies for use in lightweight HTTP clients (Axios, Requests) without needing a browser.
• Bypassing captchas without paying 3rd-party solving services.

What it returns

Each successful execution returns:

• Session Cookies: The full array of browser cookies generated after the captcha is solved (e.g., TencentCaptchaTicket, Randstr), which you can inject into your own scripts.
• Status & Message: Clear indicators of success or failure.
• Resulting URL: The final URL the browser landed on after the bypass.
• Extracted Data: Optional raw JSON data intercepted from the target website's backend APIs immediately after the captcha passes.

Input example

{
  "targetUrl": "https://login.tencent.com/",
  "triggerSelector": "#login-btn",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Input fields

Field	Description	Default
targetUrl	The URL of the webpage where the Captcha appears.	https://www.jtexpress.co.th/tracking
triggerSelector	(Optional) CSS Selector of the button to click to trigger the Captcha. Leave blank if it loads automatically.	Empty
preActionScript	(Optional) Custom JavaScript to run in the browser BEFORE waiting for the captcha (e.g., to fill a login form or tracking number). Has access to the page object.	Empty
proxyConfiguration	Apify proxy settings to prevent IP bans during the bypass process.	Apify Proxy enabled

Output example

{
  "targetUrl": "https://login.tencent.com/",
  "success": true,
  "solvedAt": "2026-06-04T16:41:00.000Z",
  "cookies": [
    {
      "name": "TDC_ticket",
      "value": "tr03152648...88493",
      "domain": ".qq.com",
      "path": "/",
      "expires": 1718000000,
      "httpOnly": false,
      "secure": false
    },
    {
      "name": "verifysession",
      "value": "x2y3z4...",
      "domain": ".qq.com",
      "path": "/",
      "expires": 1718000000,
      "httpOnly": false,
      "secure": false
    }
  ]
}

Advanced Usage (Pre-Action Script)

Some websites (like logistics trackers or complex logins) require you to fill out forms and navigate before the Captcha pops up. You can easily automate this by providing raw JavaScript to the preActionScript field.

The script runs inside the Node.js context and has full access to the Playwright page object.

Example: Automating J&T Express Tracking

{
  "targetUrl": "https://www.jtexpress.co.th/tracking",
  "preActionScript": "await page.waitForTimeout(3000);\nawait page.locator('button.cookies_btn').last().click().catch(() => {});\nawait page.waitForSelector('input.input_search', { timeout: 10000 });\nawait page.locator('input.input_search').click();\nawait page.locator('input.input_search').fill('823456789012');",
  "triggerSelector": "span.search_btn",
  "proxyConfiguration": { "useApifyProxy": true }
}

How it works

1. The Actor launches a headless Chromium browser using Playwright with stealth plugins.
2. It navigates to the targetUrl.
3. It intercepts the network requests to grab the background image (img_index=1) and the puzzle piece (img_index=0) natively without taking screenshots.
4. It feeds both images into an OpenCV Template Matching algorithm to calculate the exact X-axis distance.
5. It performs a randomized, human-like mouse drag (with slight overshoots and pauses) to solve the slider.
6. It extracts the resulting Cookies and intercepted Data, pushing them to the Apify Dataset.

Notes

• Zero 3rd-Party Fees: This Actor solves the captcha natively using CPU/Memory, meaning you don't need to pay API keys to 2Captcha or CapSolver.
• Proxy Required: If you are solving hundreds of captchas per hour on the same site, make sure useApifyProxy is enabled to avoid fingerprint/IP bans.

Local run

npm install
INPUT='{"targetUrl":"https://login.tencent.com/","triggerSelector":"#login-btn"}' npm start