Skip to content
Back to the integration guide

GeeTest v3 walkthrough

GeeTest v3 needs a fresh gt and challenge pair from the target site's initialization response. This page explains the flow; it does not render a live v3 challenge.

Integration walkthrough

This task needs a target site's challenge or session. Follow the input guide to test it in your own integration.

  1. Open your target's Network panel and find its GeeTest initialization request. Read gt and challenge from the response for that same session.
  2. Submit the pair with the exact page URL. A previous challenge or a pair from another session may be rejected.
  3. Poll the task until ready, then use challenge, validate, and seccode in the target's original verification flow.
Try the GeeTest v4 widget

Request example — replace placeholders with your current values. This preview does not submit a task.

request.json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "GeeTestV3TaskProxyLess",
    "websiteURL": "YOUR_TARGET_PAGE_URL",
    "gt": "GT_FROM_INITIALIZATION",
    "challenge": "FRESH_CHALLENGE_FROM_INITIALIZATION"
  }
}

Put the result to work

  1. Collect the current inputsUse the exact target page and its current challenge values. Keep the original proxy, cookies, and browser identity for session-bound tasks.
  2. Create and poll the taskRun the matching integration script from your backend. Check API errors and poll getTaskResult until the task is ready.
  3. Apply the returned solutionUse the result as the provider expects: a token, validation fields, cookies, or image answer. Read the response guide

Try another demo