Skip to main content
Twocaptcha logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: TWOCAPTCHA
  • Version: 20261101_00

Tools

Slug: TWOCAPTCHA_CREATE_TASKCreates a new CAPTCHA-solving task and returns a taskId for retrieving results. Supports multiple captcha types: reCAPTCHA v2/v3, hCaptcha, image recognition, and more. After creating a task, use the returned taskId with getTaskResult to retrieve the solution. Requires sufficient account balance to process tasks.

Input Parameters

object
required
Task object with ‘type’ field and type-specific parameters. Common types: ‘ImageToTextTask’ (requires ‘body’ as base64 image), ‘RecaptchaV2TaskProxyless’ (requires ‘websiteURL’ and ‘websiteKey’), ‘RecaptchaV3TaskProxyless’ (requires ‘websiteURL’, ‘websiteKey’, ‘minScore’, ‘pageAction’), ‘HCaptchaTaskProxyless’ (requires ‘websiteURL’ and ‘websiteKey’). Example: {‘type’:‘RecaptchaV2TaskProxyless’,‘websiteURL’:https://example.com,‘websiteKey’:‘6Le-abc…’}
integer
Your software ID from 2Captcha’s Software Catalog.
string
required
Your 2Captcha API key (32-character hexadecimal string).
string
Your registered pingback URL to receive results.
string ("en" | "rn")
Worker language preference: ‘en’ for English (default), ‘rn’ for Russian.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWOCAPTCHA_GET_BALANCETool to retrieve your 2Captcha account balance in USD. Use when you need to check available funds before creating captcha-solving tasks.

Input Parameters

string
required
Your 2Captcha API key (32-character hexadecimal string).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWOCAPTCHA_REPORT_INCORRECTReport that a CAPTCHA solution was declined by the target website. Use this action to provide feedback when a solved CAPTCHA is rejected, enabling 2Captcha to improve accuracy and potentially issue refunds for incorrectly solved tasks.

Input Parameters

integer
required
The ID of the task that was incorrectly solved. This is the taskId returned from createTask.
string
required
Your 2Captcha API key (32-character hexadecimal string).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWOCAPTCHA_REPORT_INCORRECT_IMAGE_CAPTCHAReport that an image captcha solution was incorrect. Alias for reportIncorrect method. Use this when you receive an incorrect captcha solution from 2Captcha to report the issue. Made for compatibility with certain software libraries. Successful reports may result in refunds.

Input Parameters

integer
required
The ID of the task to report as incorrect. Must be a valid task ID from a previous captcha solution.
string
required
Your 2Captcha API key (32-character hexadecimal string).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TWOCAPTCHA_TEST_REQUESTSend a test request to 2Captcha and return its raw response in a structured result. The request supplies the client key.

Input Parameters

string
required
Your 2Captcha API key for authentication. This is the only required parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not