CaptchaSonic icon

CaptchaSonic

AI-powered CAPTCHA solving — supports reCAPTCHA, popularcaptcha, Turnstile, GeeTest, DataDome, AWS WAF, and more

Token → GeeTest V4

AI-generated

Summary

Solves a GeeTest V4 captcha through the CaptchaSonic API and returns the solution token data. It submits a task, then polls every 3 seconds for up to 120 seconds until the result is ready.

Inputs

  • Task Type (required) — GeeTestTaskProxyLess (default) or GeeTestTask (uses a proxy).
  • Website URL (required) — URL of the page where the GeeTest captcha appears.
  • Website Key — The GeeTest V4 captcha_id. Sent as captchaId. Not marked required in the UI, but V4 needs it.
  • Proxy — Proxy as protocol://user:password@host:port. Needed for the non-ProxyLess task type.
  • User Agent — Browser User-Agent string to use when solving.
  • Optional Fields — Collection of extra fields. Non-empty values are added to the task. Cookies and apiDomain are passed through at the top level, and cdata and action go under metadata. Most of the listed fields (reCAPTCHA-oriented ones such as Min Score and Is Invisible) are not relevant to GeeTest.

Output shape

One item per input item: { success: true, data: }. The data is the getTaskResult response, which has status 'ready' and the solution.

The solution fields inside data are determined by the API and are not defined in the node. Failures, API errors, and the 120 s timeout throw an error. With Continue On Fail enabled, the item instead contains { error: message }. The credential captchaSonicApi (API key) is required.

Examples

Example 1: Solve a GeeTest V4 captcha on a login page without a proxy

Task Type: GeeTest (Proxy-Less); Website URL: https://example.com/login; Website Key: the captcha_id from the page.

Example 2: Solve with a specific IP and browser fingerprint

Task Type: GeeTest; Proxy: http://user:pass@1.2.3.4:8080; User Agent: a Chrome UA string; Website Key: captcha_id.

Links

Discussion