CAPTCHA · Background Automatic Decoding

One API call, Instantly Solve Cloudflare Turnstile
Get a usable token directly from the sitekey

No manual clicking is required, and there is no need to maintain a browser or decoder. Submit the Turnstile sitekey and URL of the target website, and the interface will decode a valid cf-turnstile-response token in the background, which can be used directly for form submission, login, registration, and automation processes.

Integrate Now View Documentation
1
Token output per call
async
Supports asynchronous submission + polling
120s
Token validity period
from $0.0057
Starting from each decoding

Core Capabilities

Cloudflare Turnstile direct output solution for automation testing, web scraping, and quality monitoring teams.

Direct Token Output

Submit sitekey + URL, return a cf-turnstile-response token that can be submitted directly, skipping the entire challenge.

Synchronous / Asynchronous

Default synchronous blocking return; pass in async:true to immediately get task_id, poll /captcha/tasks for results, suitable for rotating multiple decoders.

Custom Parameters

Supports optional action and cdata, accurately matching the custom configuration set for the Turnstile component on the target site.

Visible Duration

Response includes started_at / finished_at / elapsed, making it easy for you to monitor the processing delay of each decoding.

Pay-per-use

Charges only once when a token is successfully obtained; in asynchronous mode, canceling unfinished tasks incurs no cost.

Unified Access

Uses the same Bearer token and the same /captcha/tasks polling endpoint as hCaptcha, reCAPTCHA, and other verification interfaces.

Synchronous results, asynchronous non-blocking

In simple scenarios, request the token directly in one go; during high concurrency or when rotating multiple captchas, use async:true to immediately get the task_id, schedule other tasks first, and later return to poll for results using the same /captcha/tasks endpoint.

  • Synchronous mode: one request blocks until the token is solved
  • Asynchronous mode: async:true immediately returns task_id, polls for results
  • Billing occurs only when the token is solved; unfinished tasks can be abandoned without charge
POST /captcha/token/turnstile
{
  "token": "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM......",
  "started_at": "2026-07-24T09:34:13+00:00",
  "finished_at": "2026-07-24T09:34:25+00:00",
  "elapsed": 12.4
}

Quick Access Example

After obtaining the API Token, submit the sitekey and URL to directly get the token.

curl -X POST "https://api.acedata.cloud/captcha/token/turnstile" \
  -H "authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "website_key": "0x4AAAAAAADnPIDROrmt1Wwj",
    "website_url": "https://react-turnstile.vercel.app"
  }'

The returned token is the cf-turnstile-response value, for one-time use, valid for 120s, recommended to submit to the target website within 60s.

Three Steps to Get Started

From obtaining the key to getting the token, it takes just a few minutes.

1

Get Token

Obtain your API Token from the console; one Token calls all services on the platform.

2

Get sitekey

Search for cf-turnstile on the target website, read data-sitekey as website_key.

3

Call the API

Submit website_key and website_url to get the token directly.

4

Submit the Form

Submit the token as cf-turnstile-response to the target website to complete the verification.

Typical Scenarios

Automated Testing

Provide valid tokens required for end-to-end automated testing of login / registration / ordering processes protected by Turnstile.

Data Collection

Within the scope of compliance authorization, allow crawlers to bypass Turnstile human verification and stably collect target data.

Quality Monitoring

Conduct regular availability and performance testing on key pages deployed with Turnstile.

Simple and Transparent Pricing

Charges based on successful decoding counts, with bulk packages saving up to 37%.

Token Turnstile

from $0.0057
per successful decode

Bulk Packages

up to 37% OFF
the larger the usage, the lower the unit price

Frequently Asked Questions

How to use the returned token?

The token is the cf-turnstile-response value of the target website's Turnstile component, which should be POSTed along with the form to the target website. It is for one-time use, valid for 120s, and it is recommended to use it within 60s.

Is asynchronous support available?

Yes. Passing async:true in the request body will immediately return task_id, and then use POST /captcha/tasks to poll for results (recommended every 3-5 seconds). Creating and polling for "processing" does not incur charges, only when successfully obtaining the token is it charged once.

What are action and cdata?

Both are optional parameters and only need to be passed when the target website has set custom action or cData for the Turnstile component, used for precise matching of that instance.

Can I bring my own proxy (BYOP)?

Cloudflare Turnstile does not currently support bringing your own proxy, and this interface does not accept the proxy parameter; if passed, it will return 400 invalid_proxy. If you need a proxy exit IP, please use the hCaptcha / reCAPTCHA interface that supports BYOP.

Explore More

hCaptcha CAPTCHA Recognition

Submit sitekey to directly obtain hCaptcha token, supporting image recognition and bringing your own proxy.

reCAPTCHA CAPTCHA Recognition

Covering reCAPTCHA v2 / v3 and enterprise version token output and image recognition.

SERP Search API

Structured Google search results, covering web pages, images, news, etc.

Start Decoding Cloudflare Turnstile

Submit sitekey and URL, one API call directly outputs a usable token, integrating into your automation process in minutes.

Integrate Now