2Captcha | AI Agent Tools

2captcha.com

•

API Key

About 2Captcha

2Captcha provides businesses with a reliable service to solve various types of captchas, including reCAPTCHA, image, audio, and other complex challenges, enabling uninterrupted automation workflows. It leverages a hybrid system combining human workers and AI to ensure high accuracy and fast response times, supporting 24/7 availability. The platform offers easy API integration compatible with multiple programming languages, allowing seamless embedding into existing automation systems. By using 2Captcha, businesses can reduce manual intervention, accelerate data scraping, and maintain compliance with ethical standards for accessing public web data. Additionally, it offers competitive pricing with no hidden fees and a referral program to incentivize usage growth.

AI Agent Use Cases

• AI agents can integrate 2Captcha's API to autonomously solve captcha challenges encountered during web scraping or data extraction tasks, ensuring continuous data flow without human interruption. They can dynamically manage captcha solving requests based on task priority and budget constraints, optimizing operational efficiency. Furthermore, AI agents can monitor captcha solving success rates and adjust strategies in real-time to maintain high automation reliability for business intelligence and competitive analysis.

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Captcha Task

5 inputs

Creates a new captcha recognition task of a specified type.

Inputs

clientKey

Your 2captcha API key used for authentication; required in every API call.

task

The captcha-solving task object; must specify type and other parameters required by the target captcha type.

languagePool

Optionally select workers by language: 'en' for English-speaking, 'rn' for Russian-speaking; only applies to image or text-based captchas.

callbackUrl

URL of your webhook endpoint to receive automatic captcha solution results asynchronously.

softId

Optional software ID if you have registered your software in the 2captcha catalog.

Get Captcha Solution By Task Id

5 inputs

Retrieve the solution or status of a previously submitted captcha task using the task ID.

Inputs

key

Your API key for authenticating requests. This must be the exact 32-character API key from your 2Captcha account.

action

Defines the action to perform. Use the value 'get' when requesting the answer for a captcha task.

The unique numeric ID returned by a successful submission to in.php. This identifies the captcha task whose solution you want to retrieve.

json

If set to 1, the response will be returned in JSON format; by default (0 or not set), response is plain text.

header_acao

If set to 1, the response will include 'Access-Control-Allow-Origin: *' header (for CORS requests in web apps). Defaults to 0.

Retrieve Captcha Task Result

2 inputs

Returns the current status and solution of a submitted captcha solving task.

Inputs

clientKey

Your unique API key for authenticating API requests; this must correspond to your 2captcha account and be included as the 'clientKey' property in the request body.

taskId

The unique numeric identifier of the captcha task whose result is being requested, as returned previously by createTask.

Submit Captcha Task For Solving

14 inputs

Creates and submits a new captcha-solving task to 2Captcha, returning the task ID needed to retrieve the solution.

Inputs

key

Your personal API key from your 2Captcha account, used for authentication. Must be exactly 32 alphanumeric characters.

method

The type of captcha to solve (e.g., 'userrecaptcha' for reCAPTCHA V2/V3, 'post' or 'base64' for normal/image captcha, etc.). Value depends on the captcha you are solving.

file

Image file containing the captcha challenge if you are solving a normal/image captcha and selecting 'post' as method. Mutually exclusive with 'body'. Required only for file uploads.

body

Base64-encoded data for the captcha image (or audio for audio tasks). Required if submitting data in base64; mutually exclusive with 'file'.

googlekey

The public key ('sitekey', 'k') needed to solve reCAPTCHA V2/V3. Mandatory if method is 'userrecaptcha'.

pageurl

The complete URL of the page where the captcha is found. Required for most token-based or JS-based methods like reCAPTCHA, FunCaptcha, Geetest, etc.

userAgent

The user agent string to be used when solving some captchas (e.g., for reCAPTCHA with cookies). Optional unless specifically required for your captcha method.

Cookies to supply to the worker, formatted as KEY:Value;KEY2:Value2; etc. Used for certain advanced captcha types but not always required.

json

If set to 1, responses will be in JSON format instead of plain text. Default is 0.

header_acao

Set to 1 to include 'Access-Control-Allow-Origin: *' HTTP header in the response, used for AJAX/CORS requests. Default is 0.

pingback

A callback URL where 2Captcha will send the result via HTTP POST once the captcha is solved. You must register this URL/IP with 2Captcha.

soft_id

Developer/software ID if you are participating in the 2Captcha partners program. Not required for standard use.

proxy

Proxy connection string (e.g., login:password@IP:PORT) if your method supports or requires solving through a proxy.

proxytype

Type of the proxy used when applicable.

About 2Captcha

AI Agent Use Cases

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Captcha Task

5 inputs

Creates a new captcha recognition task of a specified type.

Inputs

clientKey

Your 2captcha API key used for authentication; required in every API call.

task

The captcha-solving task object; must specify type and other parameters required by the target captcha type.

languagePool

Optionally select workers by language: 'en' for English-speaking, 'rn' for Russian-speaking; only applies to image or text-based captchas.

callbackUrl

URL of your webhook endpoint to receive automatic captcha solution results asynchronously.

softId

Optional software ID if you have registered your software in the 2captcha catalog.

Get Captcha Solution By Task Id

5 inputs

Retrieve the solution or status of a previously submitted captcha task using the task ID.

Inputs

key

Your API key for authenticating requests. This must be the exact 32-character API key from your 2Captcha account.

action

Defines the action to perform. Use the value 'get' when requesting the answer for a captcha task.

The unique numeric ID returned by a successful submission to in.php. This identifies the captcha task whose solution you want to retrieve.

json

If set to 1, the response will be returned in JSON format; by default (0 or not set), response is plain text.

header_acao

If set to 1, the response will include 'Access-Control-Allow-Origin: *' header (for CORS requests in web apps). Defaults to 0.

Retrieve Captcha Task Result

2 inputs

Returns the current status and solution of a submitted captcha solving task.

Inputs

clientKey

Your unique API key for authenticating API requests; this must correspond to your 2captcha account and be included as the 'clientKey' property in the request body.

taskId

The unique numeric identifier of the captcha task whose result is being requested, as returned previously by createTask.

Submit Captcha Task For Solving

14 inputs

Creates and submits a new captcha-solving task to 2Captcha, returning the task ID needed to retrieve the solution.

Inputs

key

Your personal API key from your 2Captcha account, used for authentication. Must be exactly 32 alphanumeric characters.

method

The type of captcha to solve (e.g., 'userrecaptcha' for reCAPTCHA V2/V3, 'post' or 'base64' for normal/image captcha, etc.). Value depends on the captcha you are solving.

file

Image file containing the captcha challenge if you are solving a normal/image captcha and selecting 'post' as method. Mutually exclusive with 'body'. Required only for file uploads.

body

Base64-encoded data for the captcha image (or audio for audio tasks). Required if submitting data in base64; mutually exclusive with 'file'.

googlekey

The public key ('sitekey', 'k') needed to solve reCAPTCHA V2/V3. Mandatory if method is 'userrecaptcha'.

pageurl

The complete URL of the page where the captcha is found. Required for most token-based or JS-based methods like reCAPTCHA, FunCaptcha, Geetest, etc.

userAgent

The user agent string to be used when solving some captchas (e.g., for reCAPTCHA with cookies). Optional unless specifically required for your captcha method.

Cookies to supply to the worker, formatted as KEY:Value;KEY2:Value2; etc. Used for certain advanced captcha types but not always required.

json

If set to 1, responses will be in JSON format instead of plain text. Default is 0.

header_acao

Set to 1 to include 'Access-Control-Allow-Origin: *' HTTP header in the response, used for AJAX/CORS requests. Default is 0.

pingback

A callback URL where 2Captcha will send the result via HTTP POST once the captcha is solved. You must register this URL/IP with 2Captcha.

soft_id

Developer/software ID if you are participating in the 2Captcha partners program. Not required for standard use.

proxy

Proxy connection string (e.g., login:password@IP:PORT) if your method supports or requires solving through a proxy.

proxytype

Type of the proxy used when applicable.