# Tencent Cloud Captcha API

> Tencent Cloud Captcha API on Apizie: 18 endpoints (Describe Captcha App Id Info, Describe Captcha Data, Describe Captcha Data Sum, Describe Captcha Mini Data, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:tencent-captcha/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-captcha`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-captcha
- OpenAPI: https://apizie.tech/api/cloud/tencent-captcha/openapi.json

Tencent Cloud API 3.0 for Captcha (captcha). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Describe Captcha App Id Info
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-app-id-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |

### Describe Captcha Data
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| End | integer | yes |  |
| Type | integer | yes |  |

### Describe Captcha Data Sum
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-data-sum` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| End | integer | yes |  |

### Describe Captcha Mini Data
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-mini-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| End | integer | yes |  |
| Type | integer | yes |  |

### Describe Captcha Mini Data Sum
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-mini-data-sum` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| End | integer | yes |  |

### Describe Captcha Mini Oper Data
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-mini-oper-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| Type | integer | yes |  |
| End | integer | no |  |

### Describe Captcha Mini Result
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-mini-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaType | integer | yes |  |
| Ticket | string | yes |  |
| UserIp | string | yes |  |
| CaptchaAppId | integer | yes |  |
| AppSecretKey | string | yes |  |
| BusinessId | integer | no |  |
| SceneId | integer | no |  |
| MacAddress | string | no |  |
| Imei | string | no |  |

### Describe Captcha Mini Risk Result
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-mini-risk-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaType | integer | yes |  |
| Ticket | string | yes |  |
| UserIp | string | yes |  |
| CaptchaAppId | integer | yes |  |
| AppSecretKey | string | yes |  |
| BusinessId | integer | no |  |
| SceneId | integer | no |  |
| MacAddress | string | no |  |
| Imei | string | no |  |
| SceneCode | integer | no |  |
| WeChatOpenId | string | no |  |

### Describe Captcha Oper Data
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-oper-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| Type | integer | yes |  |
| End | integer | no |  |

### Describe Captcha Rce Result
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-rce-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaType | integer | yes |  |
| Ticket | string | yes |  |
| UserIp | string | yes |  |
| Randstr | string | yes |  |
| CaptchaAppId | integer | yes |  |
| AppSecretKey | string | yes |  |
| BusinessId | integer | no |  |
| SceneId | integer | no |  |
| MacAddress | string | no |  |
| Imei | string | no |  |
| NeedGetCaptchaTime | integer | no |  |

### Describe Captcha Result
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaType | integer | yes |  |
| Ticket | string | yes |  |
| UserIp | string | yes |  |
| Randstr | string | yes |  |
| CaptchaAppId | integer | yes |  |
| AppSecretKey | string | yes |  |
| BusinessId | integer | no |  |
| SceneId | integer | no |  |
| MacAddress | string | no |  |
| Imei | string | no |  |
| NeedGetCaptchaTime | integer | no |  |

### Describe Captcha Ticket Data
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-ticket-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| Start | integer | yes |  |
| End | integer | no |  |

### Describe Captcha User All App Id
`POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-user-all-app-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Get Request Statistics
`POST https://apizie.tech/v1/cloud:tencent-captcha/get-request-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | string | yes |  |
| StartTimeStr | string | yes |  |
| EndTimeStr | string | yes |  |
| Dimension | string | yes |  |

### Get Ticket Statistics
`POST https://apizie.tech/v1/cloud:tencent-captcha/get-ticket-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | string | yes |  |
| StartTimeStr | string | yes |  |
| EndTimeStr | string | yes |  |
| Dimension | string | yes |  |

### Get Total Request Statistics
`POST https://apizie.tech/v1/cloud:tencent-captcha/get-total-request-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTimeStr | string | yes |  |
| EndTimeStr | string | yes |  |
| Dimension | string | yes |  |

### Get Total Ticket Statistics
`POST https://apizie.tech/v1/cloud:tencent-captcha/get-total-ticket-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTimeStr | string | yes |  |
| EndTimeStr | string | yes |  |
| Dimension | string | yes |  |

### Update Captcha App Id Info
`POST https://apizie.tech/v1/cloud:tencent-captcha/update-captcha-app-id-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CaptchaAppId | integer | yes |  |
| AppName | string | yes |  |
| DomainLimit | string | yes |  |
| SceneType | integer | yes |  |
| CapType | integer | yes |  |
| EvilInterceptGrade | integer | yes |  |
| SmartVerify | integer | yes |  |
| SmartEngine | integer | yes |  |
| SchemeColor | string | yes |  |
| CaptchaLanguage | integer | yes |  |
| MailAlarm | string | yes |  |
| TopFullScreen | integer | yes |  |
| TrafficThreshold | integer | yes |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-app-id-info" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Captcha API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-captcha/describe-captcha-app-id-info with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Captcha API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Captcha itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Captcha API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-captcha.

### What is the status of the Tencent Cloud Captcha API?
Needs your own provider key (bring your own key)