Actions21
- Token Actions
- Recognition Actions
Token → GeeTest V4
AI-generatedSummary
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 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.