See llms.txt for all machine-readable content.

Back to Templates

Solve image CAPTCHAs via webhook using CaptchaSonic

Created by

Created by: captchasonic || captchasonic00
captchasonic

Last update

Last update 3 days ago

Categories

Share

Quick overview

This workflow exposes a POST webhook that accepts base64 CAPTCHA images and uses the CaptchaSonic community node to solve multiple CAPTCHA types (OCR, reCAPTCHA v2, AWS WAF, TikTok, Binance, and more), returning a standardized JSON response.

How it works

  1. Receives a POST request on the captchasonic-solve webhook containing a JSON body with a type and required fields like image (base64) and sometimes question.
  2. Validates the request payload, checks required fields for the requested CAPTCHA type, and routes the request to the matching solver.
  3. Sends the image challenge to CaptchaSonic using the appropriate recognition operation for the selected type.
  4. Normalizes the CaptchaSonic result into a consistent JSON structure with success, type, solution, and a solvedAt timestamp.
  5. Returns the formatted solution to the original webhook caller, or responds with HTTP 400 and an error message if validation fails.

Setup

  1. Self-host n8n and install the n8n-nodes-captchasonic community node.
  2. Create and select a CaptchaSonic API credential (API key from https://my.captchasonic.com) for the CaptchaSonic nodes.
  3. Activate the workflow, copy the production webhook URL for captchasonic-solve, and configure your client to POST JSON with type plus the required fields (including a base64 image and optional question depending on type).

Requirements

Customization

  • • Add new CaptchaSonic solver branches to the Switch node for additional CAPTCHA types
  • • Modify the Format CAPTCHA Solution code node to change the JSON response structure
  • • Adjust validation rules in the Validate CAPTCHA Request code node to add or remove required fields

Additional info

Supported CAPTCHA types: imagetotext, recaptchav2, popularcaptcha, awswaf, blsocr, tiktok, binance, visionengine. Send a POST request with {"type": "imagetotext", "image": "<base64>"} to the webhook URL. Full API docs at https://docs.captchasonic.com