Skip to main content

hCaptcha

Solves hCaptcha challenges using the AntiCaptcha service.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Website Key - The hCaptcha website key obtained from the target website.
  • Website URL - The full URL of the website where the hCaptcha is located.

Options​

  • Timeout - The maximum time (in seconds) to wait for the captcha to be solved. Default is 180 seconds.
  • Credentials - The AntiCaptcha API token credential used to authenticate with the service.

Output​

  • result - The solved hCaptcha token that can be used to bypass the challenge.

How It Works​

The hCaptcha node integrates with the AntiCaptcha service to automatically solve hCaptcha challenges. When executed, the node:

  1. Validates the provided inputs (Website Key and Website URL)
  2. Creates a task on the AntiCaptcha service using the HCaptchaTaskProxyless type
  3. Continuously checks the task status until it's completed or times out
  4. Returns the solved captcha token as the result

Requirements​

  • A valid AntiCaptcha account with sufficient balance
  • The hCaptcha website key from the target website
  • The full URL of the page containing the hCaptcha challenge

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Website Key
  • Empty or invalid Website URL
  • Empty or invalid AntiCaptcha token credential
  • Timeout exceeded while waiting for captcha solution
  • AntiCaptcha service errors

Usage Notes​

  • The AntiCaptcha service charges per solved captcha, so ensure your account has sufficient balance
  • The default timeout is 180 seconds, but this can be adjusted based on your needs
  • The solved token is typically valid for a short period, so use it immediately after receiving it
  • For best results, ensure the Website URL exactly matches the domain where the hCaptcha appears