Skip to content
Last updated

Geetest V3 is an interactive CAPTCHA that typically requires users to either drag a puzzle piece into place or select images in a specific sequence. CaptchaAI automates this process by analyzing the challenge and returning the correct response values needed to bypass verification.

Integration Workflow

  1. Extract dynamic Geetest parameters from the target site:

    • gt: Public site key (usually static).
    • challenge: Dynamic token loaded with the CAPTCHA - must be freshly retrieved for each solve attempt.

    Critical: The challenge becomes invalid once the CAPTCHA is loaded or after a short time. To get a valid one, replay the initial CAPTCHA setup request (observed via browser DevTools → Network tab) immediately before submitting to CaptchaAI.

  2. Submit the task:

    • For API V1: Send a request to in.php with method=geetest, gt, challenge, and pageurl.
      → See API V1 – Geetest V3
  1. Receive a task ID (e.g., 0123456789) and wait 10–15 seconds.

  2. Poll for the result:

  1. Process the response:
    Upon success, you’ll receive three values:

    • challenge
    • validate
    • seccode

    These must be submitted to the target site in fields or parameters named:

    • geetest_challenge
    • geetest_validate
    • geetest_seccode

Note: Geetest responses are single-use and tightly bound to the original challenge and page context. Reusing or delaying submission will cause validation failure.