2Captcha API

Name: 2Captcha API
Brand: 2Captcha API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData TransformationapiKey5 EndpointsREST

For Agents

Solve reCAPTCHA, hCaptcha, Cloudflare Turnstile, and image captchas on behalf of a workflow by submitting a task and polling for the solution token.

Install Jentic One Beta

Connect the 2Captcha API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the 2Captcha API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with 2Captcha API.

Submit reCAPTCHA v2, reCAPTCHA v3, hCaptcha, and Cloudflare Turnstile tasks for human or AI-assisted solving

Solve image-to-text and FunCaptcha challenges encountered while scraping or automating browser flows

Poll task status and retrieve the resulting captcha token, gRecaptchaResponse, or text answer once ready

GET STARTED

Start building with 2Captcha API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use 2Captcha API for, with concrete tasks.

★ Web Scraping Behind reCAPTCHA

Scrapers and data-collection agents frequently hit reCAPTCHA v2 or v3 challenges when fetching pricing, listings, or public records. With the 2Captcha API the agent posts the site key and page URL to /createTask using a RecaptchaV2TaskProxyless task, polls /getTaskResult every few seconds until the status is ready, and injects the returned gRecaptchaResponse token into the target form. Solving typically completes in 15-45 seconds depending on captcha type and load.

Call /createTask with a RecaptchaV2TaskProxyless task containing the websiteURL and websiteKey, poll /getTaskResult until status is 'ready', and return the gRecaptchaResponse token to the calling scraper

Automated Account Sign-Up Flows

QA agents and onboarding bots that create test accounts on third-party services often need to clear an hCaptcha or Turnstile challenge during sign-up. 2Captcha accepts a HCaptchaTaskProxyless or TurnstileTaskProxyless task with the page URL and site key, returns a token via /getTaskResult, and the agent submits the registration form with that token attached. End-to-end the captcha step usually adds under a minute to the sign-up flow.

Submit a TurnstileTaskProxyless task to /createTask with the registration page URL and Turnstile sitekey, then poll /getTaskResult and return the resulting token to the sign-up form handler

Cost Control and Accuracy Feedback

Operations teams running large captcha-solving workloads need to monitor spend and prune incorrect solutions. /getBalance returns the current prepaid balance so an agent can throttle or pause submissions when funds run low, and /reportIncorrect refunds the cost of solutions that did not work on the target site, which also signals the worker pool to retrain. Together these two endpoints let an agent close the loop on cost and quality without leaving the API.

Call /getBalance and if the value is below 1.0 USD send an alert; for any solution that failed on the target site, call /reportIncorrect with the original taskId to claim a refund

AI Agent Captcha Resolver via Jentic

An AI agent driving a browser or HTTP workflow through Jentic can treat 2Captcha as a drop-in captcha resolver. The agent searches Jentic for 'solve a captcha', loads the createTask schema, executes the call with the site key and URL it scraped from the page, then loads getTaskResult and polls until ready. The 2Captcha API key lives in the Jentic vault, so the agent never sees the raw clientKey value — Jentic injects it into the request at execution time.

Search Jentic for 'solve a captcha', load the 2captcha createTask and getTaskResult operations, submit the captcha task, and poll until the solution token is returned

Key Endpoints

5 endpoints — jentic publishes the only available openapi specification for 2captcha api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/createTask

Create a captcha solving task

POST

/getTaskResult

Poll for the result of a submitted task

POST

/getBalance

Get the current account balance

POST

/reportCorrect

Report a correctly solved task

POST

/reportIncorrect

Report an incorrectly solved task and request a refund

POST

/createTask

Create a captcha solving task

POST

/getTaskResult

Poll for the result of a submitted task

POST

/getBalance

Get the current account balance

POST

/reportCorrect

Report a correctly solved task

POST

/reportIncorrect

Report an incorrectly solved task and request a refund

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The 2Captcha clientKey is stored encrypted in the Jentic vault (MAXsystem) and injected into the request body at execution time. Agents call createTask without ever seeing the raw key, which prevents the secret from leaking into prompts, logs, or model context.

Intent-based discovery

Agents search Jentic by intent ('solve a recaptcha', 'get captcha result', 'check captcha balance') and Jentic returns the matching 2Captcha operation along with its input schema, so the agent can construct the correct task type without reading 2Captcha's docs.

Time to first call

Direct 2Captcha integration: 1-2 days to implement task submission, polling with backoff, error handling, and balance monitoring. Through Jentic: under 30 minutes — search for the operation, load the schema, execute.

FAQs

Specific to using 2Captcha API through Jentic.

Why is there no official OpenAPI spec for 2Captcha API?

2Captcha does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call 2Captcha API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the 2Captcha API use?

The 2Captcha API uses an API key passed as the clientKey field in the JSON body of every request, not as a header. There is no OAuth or bearer token. Through Jentic the clientKey is stored encrypted in the MAXsystem vault and injected into the request at execution time, so the agent never sees the raw key value.

Can I solve reCAPTCHA v3 with the 2Captcha API?

Yes. Submit a RecaptchaV3TaskProxyless task to /createTask with the websiteURL, websiteKey, the action name, and your minimum acceptable score (typically 0.3 or 0.7), then poll /getTaskResult until status is 'ready' to retrieve the gRecaptchaResponse token. The same five-endpoint flow handles reCAPTCHA v2, hCaptcha, Turnstile, and image captchas — only the task type changes.

How do I poll for a captcha solution through Jentic?

Use Jentic's search to find the operation ('solve a captcha' or 'get captcha result'), load the getTaskResult schema, then execute it with the taskId returned from createTask. 2Captcha's docs recommend a first poll after about 5 seconds and additional polls every 5 seconds until the response status field is 'ready', at which point the solution field contains the token or text.

What are the rate limits for the 2Captcha API?

The OpenAPI spec does not declare numeric rate limits. In practice 2Captcha throttles by account: getTaskResult should be polled no more often than every 5 seconds per task, and very high createTask submission rates may be slowed under heavy load. Concurrency limits depend on your account tier — check your dashboard for the current cap.

How do I get a refund for a bad captcha solution?

Call /reportIncorrect with the taskId of the solution that did not work on the target site. 2Captcha will refund the cost of that task and feed the signal back to the worker pool. Report only solutions that genuinely failed — abusing reportIncorrect can lead to account restrictions.

Is the 2Captcha API free?

No. 2Captcha is a prepaid service — you top up a balance and each solved captcha deducts a small amount (rates vary by task type, with image captchas cheapest and reCAPTCHA / hCaptcha more expensive). Use /getBalance to read the current balance from your code so you can gate submissions when funds run low.

2Captcha API

Connect the 2Captcha API to your agent

Capabilities

Start building with 2Captcha API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs