Authorized testing · REST API
CAPTCHA Solver API for Authorized Testing
Integrate CAPTCHA and anti-bot challenge handling into websites and workflows you are authorized to test. Create a task through one REST endpoint, poll for the result, then use the returned token, cookie or recognized text.
SolveHub supports Cloudflare Turnstile and Interstitial, DataDome, Akamai Bot Manager, PerimeterX / HUMAN, Imperva, AWS WAF, Alibaba Cloud CAPTCHA, Arkose FunCaptcha and image CAPTCHA OCR. Check live availability and pricing before creating a task; you pay only for successfully completed tasks.
Read the quick startView live pricing
New accounts get 0.10 USD of free trial credit once they register and verify a Telegram account — no top-up needed, and the credit never expires. It covers one concurrent task at a time. Claim the trial credit · See the trial rules
- 10+CAPTCHA & anti-bot types
- 1REST endpoint for every type
- USDbilled per successful task
- 3console languages: EN, 中文, 日本語
Supported CAPTCHA and anti-bot challenge types
Choose the challenge type your authorized test needs, then use the same REST API to create and track the task. SolveHub covers token-based challenges such as Cloudflare Turnstile, cookie-based protections such as DataDome, and image CAPTCHA OCR. Each type has its own guide with required fields, a cURL example, result format and common errors.
Availability varies by type. Check live status and per-task pricing before you send a request.
- Image CAPTCHA OCRSolve image-based text CAPTCHAs in authorized QA with SolveHub's OCR API. Send a Base64 image, poll the task, and read the recognized text.
- Cloudflare TurnstileCreate authorized Cloudflare Turnstile tasks with the SolveHub solver API: send websiteURL and websiteKey, optional cdata/action and proxy, poll the task and receive a response token. Compare this with official test keys first.
- Cloudflare InterstitialPass the Cloudflare interstitial challenge page with the SolveHub API and reuse the clearance cookie with the returned user agent and the same proxy. Request fields, cURL example and errors.
- PerimeterX / HUMANSolve PerimeterX / HUMAN bot protection with the SolveHub API: app ID, target site, proxy and browser cookies. Learn which fields to send and how to consume the returned cookies.
- DataDomeSolve authorized DataDome challenges with the SolveHub solver API: submit the challenge URL and proxy, poll the task and receive a datadome cookie to reuse with the same IP and user agent. Fields, cURL, errors.
- Akamai Bot ManagerObtain Akamai Bot Manager browser session cookies (_abck, bm_sz) with the SolveHub API. Request fields, proxy requirements, cURL example, result format and error codes.
- Alibaba Cloud CAPTCHA 2.0Solve Alibaba Cloud CAPTCHA 2.0 with the SolveHub API: scene ID, identity prefix and the verification payload to submit back to the target site. Request fields, cURL example and errors.
- Imperva / IncapsulaSolve Imperva / Incapsula protection with the SolveHub API in reese84 or UT.mvc mode. Request fields for each mode, proxy requirements, cURL example, result cookies and errors.
- AWS WAFSolve AWS WAF challenge and CAPTCHA with the SolveHub API: challenge script URL, optional captcha script and proxy, returning an aws-waf-token. Request fields, cURL example and errors.
- Arkose FunCaptchaUse SolveHub's FunCaptcha solver API for authorized Arkose Labs QA. Review required challenge fields, proxy settings, live availability, result tokens and failures.
How the CAPTCHA Solver API Works
Use one REST workflow across supported challenge types. Set up your API key, create a task, then poll the same task until you have a result.
- Get an API keyRegister and verify your email. Activate self-service when available, or bind a key issued by SolveHub. Add funds using the options shown in your console.
- Create a taskSend the challenge type and its required fields to POST /v1/tasks. Include an Idempotency-Key, and reuse the same key and request body if you need to retry.
- Poll and use the resultRequest GET /v1/tasks/{taskId} about every 2–3 seconds. When the task completes, read the returned token, cookies or recognized text and use it in your authorized test workflow. If the task enters an uncertain state, keep checking the same taskId rather than creating a new task.
Create a task in one request
curl -sS -X POST 'https://www.tiam.codes/v1/tasks' \
-H 'Authorization: Bearer sh_REPLACE_ME' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: order-12345' \
-d '{"type":"turnstile","task":{"websiteURL":"https://example.com","websiteKey":"SITE_KEY"}}'
# → 202 {"taskId":"…","status":"queued","priceMicros":200,…}
curl -sS -H 'Authorization: Bearer sh_REPLACE_ME' 'https://www.tiam.codes/v1/tasks/TASK_ID'
# → {"status":"completed","solution":{"value":"0.EXAMPLE_TOKEN"},…}Why Choose SolveHub for Authorized CAPTCHA Testing?
- Pay for completed tasksSee the task price when you create it. SolveHub charges only when a task completes successfully; failed or cancelled tasks release the reserved amount.
- Retry without duplicate tasksSend an Idempotency-Key with each create request. Reuse the same key and request body after a timeout, and use traceId and X-Request-ID to investigate issues.
- Check availability and prices liveRead GET /v1/prices for current public availability and per-task prices. If your key has negotiated rates, GET /v1/me/prices shows the prices that apply to you.
- Manage usage in one consoleManage API keys, review usage and spending, configure task webhooks, and open support tickets. The console is available in English, Chinese and Japanese.
A CAPTCHA Solving Service for Authorized QA
SolveHub is a hosted solving service behind one REST endpoint. You send the challenge parameters for a page you are authorized to test, poll the task, and receive the token, cookie or text to feed back into your own workflow.
- Built for authorized testingQA automation, regression checks and browser integration on sites and workflows you have permission to test — not general bypass tooling.
- One REST endpointThe same create-and-poll flow covers every supported type; only the task fields differ between challenges.
- Charged per completed taskThe price is fixed at creation and only charged when a task completes; failures and cancellations release the reserved amount.
- Official test keys firstTesting your own Turnstile or FunCaptcha widget? Cloudflare and Arkose test keys are free and deterministic; use a paid task only for a real challenge flow.
Read the quick startWhat is a CAPTCHA solver?How to test Cloudflare Turnstile
CAPTCHA Solver API Pricing by Task Type
Pricing is shown in USD for each supported challenge type. Check the live table below for current availability and the public price per task. You are charged only when a task completes successfully.
| Type | Status | Per task (USD) | Per 1,000 |
|---|---|---|---|
| Image CAPTCHA OCR | Available | $0.0002 | $0.20 |
| Cloudflare Turnstile | Available | $0.0002 | $0.20 |
| Cloudflare Interstitial | Available | $0.0004 | $0.40 |
| PerimeterX / HUMAN | Available | $0.001 | $1.00 |
| DataDome | Available | $0.0012 | $1.20 |
| Akamai Bot Manager | Available | $0.0008 | $0.80 |
| Alibaba Cloud CAPTCHA 2.0 | Available | $0.0004 | $0.40 |
| Imperva / Incapsula | Available | $0.0016 | $1.60 |
| AWS WAF | Available | $0.001 | $1.00 |
| Arkose FunCaptcha | Available | $0.002 | $2.00 |
Price snapshot taken 2026-11-04 07:18 (UTC) from GET /v1/prices; the page script replaces it with live values when JavaScript runs.
Showing the 2026-11-04 07:18 (UTC) price snapshot
The price confirmed when you create a task is the price reserved for that task. Your effective rate may differ from the public table if your API key has negotiated pricing. For billing and availability, use the current API response as the source of truth.
Frequently Asked Questions
Which challenges does the SolveHub CAPTCHA solver API support?
SolveHub supports Cloudflare Turnstile and Interstitial, DataDome, Akamai Bot Manager, PerimeterX / HUMAN, Imperva / Incapsula, AWS WAF, Alibaba Cloud CAPTCHA 2.0, Arkose Labs FunCaptcha and image text CAPTCHAs. Check GET /v1/prices for each type's current availability.
How is SolveHub billed?
Prices are listed per task in USD. The price is fixed when you create a task, and the task is charged only if it completes successfully. Failed or cancelled tasks release the reserved amount.
Do I need an SDK?
No. The API uses HTTPS and JSON. Create a task with POST /v1/tasks, then poll GET /v1/tasks/{taskId}. You can use any language with an HTTP client; the documentation includes cURL and Python examples.
Do I need to provide a proxy?
It depends on the challenge type. Cookie-based protections such as DataDome, Akamai, PerimeterX and Imperva usually need your proxy so the returned cookies match the IP you will use. Turnstile and image OCR do not require one.
How long does a task take?
Processing limits vary by type, with a soft window of about 90–180 seconds. If a task enters an uncertain state, continue polling the same taskId instead of creating a new task.
How do I get an API key?
Register and verify your email. Activate self-service when available to receive a key, or bind a key issued by SolveHub. You can manage key permissions and expiry in the console.
Start Your Authorized CAPTCHA Integration
Follow the quick start to create and poll your first task. Before sending a request, check that your challenge type is currently available and review its live price. Use SolveHub only on websites and workflows you are authorized to access.
