This package integrates with Selenium or Playwright to solve any TikTok captcha in one line of code.
Project description
TikTok Captcha Solver API
This project is the SadCaptcha TikTok Captcha Solver API client. The purpose is to make integrating SadCaptcha into your Selenium, Playwright, or Async Playwright app as simple as one line of code.
Instructions for integrating with Selenium, Playwright, and Async Playwright are described below in their respective sections.
Requirements
- Python >= 3.10
- If using Selenium - Selenium properly installed and in
PATH
- If using Playwright - Playwright must be properly installed with
playwright install
- Stealth plugin - You must use the appropriate
stealth
plugin for whichever browser automation framework you are using.- For Selenium, you can use undetected-chromedriver
- For Playwright, you can use playwright-stealth
Installation
This project can be installed with pip
. Just run the following command:
pip install tiktok-captcha-solver
Selenium Client
Import the package, set up the SeleniumSolver
class, and call it whenever you need.
This turns the entire captcha detection, solution, retry, and verification process into a single line of code.
It is the recommended method if you are using Playwright.
from tiktok_captcha_solver import SeleniumSolver
from selenium_stealth import stealth
import undetected_chromedriver as uc
driver = uc.Chrome(headless=False) # Use default undetected_chromedriver configuration!
api_key = "YOUR_API_KEY_HERE"
sadcaptcha = SeleniumSolver(driver, api_key)
# Selenium code that causes a TikTok captcha...
sadcaptcha.solve_captcha_if_present()
It is crucial that you use undetected_chromedriver
with the default configuration, instead of the standard Selenium chromedriver.
Failure to use the undetected_chromedriver
will result in "Verification failed" when attempting to solve the captcha.
Playwright Client
Import the package, set up the PlaywrightSolver
class, and call it whenever you need.
This turns the entire captcha detection, solution, retry, and verification process into a single line of code.
It is the recommended method if you are using playwright.
from tiktok_captcha_solver import PlaywrightSolver
from playwright.sync_api import Page, sync_playwright
from playwright_stealth import stealth_sync
api_key = "YOUR_API_KEY_HERE"
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
stealth_sync(page) # Use default playwright_stealth configuration!
# Playwright code that causes a TikTok captcha...
sadcaptcha = PlaywrightSolver(page, api_key)
sadcaptcha.solve_captcha_if_present()
It is crucial that users of the Playwright client also use playwright-stealth
with the default configuration.
Failure to use the playwright-stealth
plugin will result in "Verification failed" when attempting to solve the captcha.
Async Playwright Client
Import the package, set up the AsyncPlaywrightSolver
class, and call it whenever you need.
This turns the entire captcha detection, solution, retry, and verification process into a single line of code.
It is the recommended method if you are using async playwright.
import asyncio
from tiktok_captcha_solver import AsyncPlaywrightSolver
from playwright.async_api import Page, async_playwright
from playwright_stealth import stealth_async
api_key = "YOUR_API_KEY_HERE"
async def main()
async with async_playwright() as p:
browser = await p.chromium.launch(headless=False)
page = await browser.new_page()
await stealth_async(page) # Use default playwright_stealth configuration!
# Playwright code that causes a TikTok captcha...
sadcaptcha = AsyncPlaywrightSolver(page, api_key)
await sadcaptcha.solve_captcha_if_present()
asyncio.run(main())
It is crucial that users of the Playwright client also use playwright-stealth
with the default configuration.
Failure to use the playwright-stealth
plugin will result in "Verification failed" when attempting to solve the captcha.
API Client
If you are not using Selenium or Playwright, you can still import and use the API client to help you make calls to SadCaptcha
from tiktok_captcha_solver import ApiClient
api_key = "YOUR_API_KEY_HERE"
client = ApiClient(api_key)
# Rotate
res = client.rotate("base64 encoded outer", "base64 encoded inner")
# Puzzle
res = client.puzzle("base64 encoded puzzle", "base64 encoded piece")
# Shapes
res = client.shapes("base64 encoded shapes image")
Troubleshooting
Captcha solved but still says Verification failed?
This common problem is due to your browser settings.
If using Selenium, you must use undetected_chromedriver
with the default settings.
If you are using Playwright, you must use the playwright_stealth
package with the default settings.
Do not change the user agent, or modify any other browser characteristics as this is easily detected and flagged as suspicious behavior.
Contact
- Homepage: https://www.sadcaptcha.com/
- Email: greg@sadcaptcha.com
- Telegram @toughdata
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tiktok_captcha_solver-0.0.14.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8533e07348e1528a429066db63e4c077c4dde22547d3bd98ba90026096a80bba |
|
MD5 | 3a02db1ad3eed90f6bb547d637c4dab4 |
|
BLAKE2b-256 | 870007c8e791e5895fdbf57e80c614918a8d4e9fcf01196c8ce0ca02675566dc |
Hashes for tiktok_captcha_solver-0.0.14-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5cc4e9b94ef4ed1c73b265dd8e06dbdcb6a180c5bb465b70916343f82f53f576 |
|
MD5 | 5ee96490d090581981542d10e55d6016 |
|
BLAKE2b-256 | 63758728b1bd5103d52ed36e8a730e53d7b6f853c98d0152e487294740abc89a |