# Twocaptcha

2Captcha is a service that provides automated CAPTCHA solving solutions, enabling developers to bypass various types of CAPTCHAs in their applications.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `TWOCAPTCHA`
- **Version:** 20260223_00

## Tools

### Create CAPTCHA Task

**Slug:** `TWOCAPTCHA_CREATE_TASK`

Creates 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task` | object | Yes | 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...'} |
| `softId` | integer | No | Your software ID from 2Captcha's Software Catalog. |
| `clientKey` | string | Yes | Your 2Captcha API key (32-character hexadecimal string). |
| `callbackUrl` | string | No | Your registered pingback URL to receive results. |
| `languagePool` | string ("en" | "rn") | No | Worker language preference: 'en' for English (default), 'rn' for Russian. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Balance

**Slug:** `TWOCAPTCHA_GET_BALANCE`

Tool to retrieve your 2Captcha account balance in USD. Use when you need to check available funds before creating captcha-solving tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `clientKey` | string | Yes | Your 2Captcha API key (32-character hexadecimal string). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Report Incorrect CAPTCHA

**Slug:** `TWOCAPTCHA_REPORT_INCORRECT`

Report 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `taskId` | integer | Yes | The ID of the task that was incorrectly solved. This is the taskId returned from createTask. |
| `clientKey` | string | Yes | Your 2Captcha API key (32-character hexadecimal string). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Report Incorrect Image Captcha

**Slug:** `TWOCAPTCHA_REPORT_INCORRECT_IMAGE_CAPTCHA`

Report 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `taskId` | integer | Yes | The ID of the task to report as incorrect. Must be a valid task ID from a previous captcha solution. |
| `clientKey` | string | Yes | Your 2Captcha API key (32-character hexadecimal string). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test Request Parameters

**Slug:** `TWOCAPTCHA_TEST_REQUEST`

Debug method to verify how the API parses request parameters. Use when troubleshooting integration issues or validating parameter formats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `clientKey` | string | Yes | Your 2Captcha API key for authentication. This is the only required parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |