Changelog

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.0] - 2026-07-26

GeeTest v3 (slide) support via geetest(gt, challenge, url, **kwargs) on both CapSkip and AsyncCapSkip. Accepts the optional api_server domain override and the usual proxy parameter. The result exposes the answer as the parsed challenge, validate, and seccode fields, while code keeps the raw JSON string CapSkip returns.
Parameter aliases apiServer and api_subdomain for api_server.
proxytype is now validated against the values CapSkip accepts (HTTP, HTTPS, SOCKS5, SOCKS5H, case-insensitive) for every proxy-capable captcha type. SOCKS4 and other values previously reached the server and came back as ERROR_BAD_PARAMETERS; they now raise ValidationException locally.

Submitting with json=1 no longer fails with ApiException: cannot recognize response. With json=1 CapSkip's in.php returns {"status": 1, "request": "<id>"} instead of OK|<id>; send() now parses both forms, so normal(..., json=1) and the equivalent reCAPTCHA/Turnstile calls submit and solve correctly. Applies to both the sync and async clients.

Polling no longer crashes with ApiException: cannot recognize response when CapSkip returns an empty response body. CapSkip returns an empty body while no result is available yet — briefly right after a captcha is submitted (before it reports CAPCHA_NOT_READY), for an unknown id, and after a solved token has already been read. The SDK now treats an empty body as "not ready" and keeps polling, so recaptcha(), turnstile(), and normal() solve reliably instead of failing on the first poll. Applies to both the sync and async clients.

Initial release of the CapSkip Python SDK
CapSkip synchronous client for the local CapSkip API
AsyncCapSkip asynchronous client (httpx + aiofiles)
Image CAPTCHA solving via normal() (file, URL, base64, or data-URI)
reCAPTCHA v2 / v3 solving via recaptcha() (invisible, enterprise, proxy)
Cloudflare Turnstile solving via turnstile() (widget and challenge page)
Turnstile automatically polls with json=1 and returns userAgent when provided
Manual workflow: send(), get_result(), solve()
Adaptive result polling — starts at 0.25s and backs off (doubling) up to the configured pollingInterval, so fast solves (e.g. image captchas) return in a fraction of a second; pollingInterval also accepts sub-second (float) values
Familiar parameter aliases (url→pageurl, score→min_score, etc.)
Proxy support via dict format {'type': '...', 'uri': '...'}
Strict per-captcha parameter validation — only documented parameters are accepted
Exception hierarchy: ValidationException, NetworkException, ApiException, TimeoutException
Example scripts for every supported captcha type
Unit tests (sync + async) with a mocked API client
Documentation: Tutorial, Getting Started, API Reference, Troubleshooting