10captcha is an AI-powered image and CAPTCHA recognition service. 10captcha's main purpose is solving your CAPTCHAs in a quick and cost effictive way by using AI "Artificial Intelligence".
We provide an API that allows you to automate the process and integrate your software with our service.
There are few simple steps to solve your captcha or recognize the image:
Type of captcha/method | Description |
---|---|
Normal Captcha | 27,500+ image captchas including, Solve Media, Google captcha, reCAPTCHA v1, Facebook captcha, etc. |
reCAPTCHA V2 | Google reCaptcha V2 |
reCAPTCHA V3 | Google reCaptcha V3 |
hCaptcha | hCaptcha |
Our API is based on HTTP requests and supports both HTTP and HTTPS protocols.
API endpoints:
https://ocr.10captcha.com/in.php
is used to submit a captchahttps://ocr.10captcha.com/res.php
is used to get the captcha solutionNEW For image captcha, now you can use https://ocr.10captcha.com/solve.php
instead of in.php
to directly get the results.
The process of solving captchas with 10captcha is really easy and it's mostly the same for all types of captchas:
347bc2896fc1812d3de5ab56a0bf4ea7
https://ocr.10captcha.com/in.php
with parameters corresponding to the type of your captcha.https://ocr.10captcha.com/res.php
to get the result.Normal Captcha is an image that contains distored but human-readable text. To solve the captcha user have to type the text from the image.
To solve the captcha with our service you have to submit the image with HTTP POST
request to our API URL: https://ocr.10captcha.com/in.php
Server accepts images in multipart or base64 format.
NEW For image captcha, now you can use https://ocr.10captcha.com/solve.php
instead of in.php
to directly get the results.
Multipart sample form
YOUR_APIKEY is Your API key.
Base64 sample form
YOUR_APIKEY is here your API key.
BASE64_FILE is base64-encoded image body.
You can provide additional parameters with your request to define what kind of captcha you'resending and to help OCR servers to solve your captcha correctly. You can find the full list of parameters in the table below.
If everything is fine server will return the ID of your captcha as plain text, like:OK|123456789 or as JSON {"status":1,"request":"123456789"} if json parameter was used.
If something went wrong server will return an error. See Error Handling chapter for the list of errors.
Make a 5 seconds timeout and submit a HTTP GET request to our API URL: https://ocr.10captcha.com/res.php
providing the captcha ID. The list of parameters is in the table below.
If everything is fine and your captcha is solved server will return the answer as plain text, like: OK|TEXT or as JSON {"status":1,"request":"TEXT"} if json parameter was used.
Otherwise server will return CAPCHA_NOT_READY that means that your captcha is not solved yet. Just repeat your request in 5 seconds.
If something went wrong server will return an error. See Error Handling chapter for the list of errors.
List of POST request parameters for https://ocr.10captcha.com/in.php
POST parameter | Type | Required | Description |
key | String | Yes | your API key |
method | String | Yes | post - defines that you're sending an image with multipart form base64 - defines that you're sending a base64 encoded image |
file | File | Yes* | Captcha image file. * - required if you submit image as a file (method=post) |
body | String | Yes* | Base64-encoded captcha image * - required if you submit image as Base64-encoded string (method=base64) |
phrase | Integer Default: 0 |
No | 0 - captcha contains one word 1 - captcha contains two or more words |
regsense | Integer Default: 0 |
No | 0 - captcha in not case sensitive 1 - captcha is case sensitive |
numeric | Integer Default: 0 |
No | 0 - not specified 1 - captcha contains only numbers 2 - captcha contains only letters 3 - captcha contains only numbers OR only letters 4 - captcha contains both numbers AND letters |
calc | Integer Default: 0 |
No | 0 - not specified 1 - captcha requires calculation (e.g. type the result 4 + 8 = ) |
min_len | Integer Default: 0 |
No | 0 - not specified 1..20 - minimal number of symbols in captcha |
max_len | Integer Default: 0 |
No | 0 - not specified 1..20 - maximal number of symbols in captcha |
language | Integer Default: 0 |
No | 0 - not specified 1 - Cyrillic captcha 2 - Latin captcha |
lang | String | No | Language code. See the list of supported languages. |
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
List of GET request parameters for https://ocr.10captcha.com/res.php
GET parameter | Type | Required | Description |
key | String | Yes | your API key |
action | String | Yes | get - get the asnwer for your captcha |
id | Integer | Yes | ID of captcha returned by in.php. |
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
header_acao | Integer Default: 0 |
No | 0 - disabled 1 - enabled. If enabled res.php will include Access-Control-Allow-Origin:* header in the response.Used for cross-domain AJAX requests in web applications. |
Request URL example:
https://ocr.10captcha.com/res.php?key=347bc2896fc1812d3de5ab56a0bf4ea7&action=get&id=123456789
reCAPTCHA V2 also known as I'm not a robot reCAPTCHA is a very popular type of captcha that looks like this:
Solving reCAPTCHA V2 with our method is pretty simple:
Look at the element's code at the page where you found reCAPTCHA.
Find a link that begins with www.google.com/recaptcha/api2/anchor or find data-sitekey parameter.
Copy the value of k parameter of the link (or value of data-sitekey parameter).
Submit a HTTP GET or POST request to our API URL: https://ocr.10captcha.com/in.php
with method set to userrecaptcha and the value found on previous step as value for googlekey and full page URL as value for pageurl. Sending proxies is not obligatory ar the moment but it's recommended.
You can find the full list of parameters in the table below.
Request URL example:
https://ocr.10captcha.com/in.php?key=347bc2896fc1812d3de5ab56a0bf4ea7&method=userrecaptcha&googlekey=6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-&pageurl=https://mysite.com/page/with/recaptcha
If everything is fine server will return the ID of your captcha as plain text, like:
OK|123456789 or as JSON {"status":1,"request":"123456789"} if
json parameter was used.
Otherwise server will return an error code.
Make a 15-20 seconds timeout then submit a HTTP GET request to our API URL:
https://ocr.10captcha.com/res.php
to get the result.
The full list of parameters is in the table below.
If captcha is already solved server will respond in plain text or JSON and return the answer token that looks like:
03AHJ_Vuve5Asa4koK3KSMyUkCq0vUFCR5Im4CwB7PzO3dCxIo11i53epEraq-uBO5mVm2XRikL8iKOWr0aG50sCuej9bXx5qcviUGSm4iK4NC_Q88flavWhaTXSh0VxoihBwBjXxwXuJZ-WGN5Sy4dtUl2wbpMqAj8Zwup1vyCaQJWFvRjYGWJ_TQBKTXNB5CCOgncqLetmJ6B6Cos7qoQyaB8ZzBOTGf5KSP6e-K9niYs772f53Oof6aJeSUDNjiKG9gN3FTrdwKwdnAwEYX-F37sI_vLB1Zs8NQo0PObHYy0b0sf7WSLkzzcIgW9GR0FwcCCm1P8lB-50GQHPEBJUHNnhJyDzwRoRAkVzrf7UkV8wKCdTwrrWqiYDgbrzURfHc2ESsp020MicJTasSiXmNRgryt-gf50q5BMkiRH7osm4DoUgsjc_XyQiEmQmxl5sqZP7aKsaE-EM00x59XsPzD3m3YI6SRCFRUevSyumBd7KmXE8VuzIO9lgnnbka4-eZynZa6vbB9cO3QjLH0xSG3-egcplD1uLGh79wC34RF49Ui3eHwua4S9XHpH6YBe7gXzz6_mv-o-fxrOuphwfrtwvvi2FGfpTexWvxhqWICMFTTjFBCEGEgj7_IFWEKirXW2RTZCVF0Gid7EtIsoEeZkPbrcUISGmgtiJkJ_KojuKwImF0G0CsTlxYTOU2sPsd5o1JDt65wGniQR2IZufnPbbK76Yh_KI2DY4cUxMfcb2fAXcFMc9dcpHg6f9wBXhUtFYTu6pi5LhhGuhpkiGcv6vWYNxMrpWJW_pV7q8mPilwkAP-zw5MJxkgijl2wDMpM-UUQ_k37FVtf-ndbQAIPG7S469doZMmb5IZYgvcB4ojqCW3Vz6Q
If captcha is not solved yet server will return CAPCHA_NOT_READY result. Repeat your request in 5 seconds.
If something went wrong server will return an error code.
Locate the element with id g-recaptcha-response and make it visible deleting display:none parameter.
Please note: sometimes content on the page is generated dynamically and you will not see this element in html source.
In such cases you have to explore javascript code that generates the content. "Inspect" option in Google Chrome can help in that.
As an alternative you can just use javascript to set the value of g-recaptcha-response field:
document.getElementById("g-recaptcha-response").innerHTML="TOKEN_FROM_10captcha";
An input field will appear on the page. And you just have to paste the answer token to that field and submit the form.
Congratulations, you've passed the recaptcha
Sometimes there's no submit button and a callback function is used isntead. The function is when reCAPTCHA is solved.
Callback function is usually defined in data-callback
parameter of reCAPTCHA, for example:
data-callback="myCallbackFunction"
Or sometimes it's defined as callback
parameter of grecaptcha.render
function, for example:
grecaptcha.render('example', {'sitekey' : 'someSitekey','callback' : myCallbackFunction,'theme' : 'dark'});
Also there's another way to find the callback function - open javascript console of your browser and explore reCAPTCHA configuration object:
___grecaptcha_cfg.clients[0].aa.l.callback
Note that aa.l may change and there can be multiple clients so you have to check clients[1], clients[2] too.
Finally all you have to do is to call that function:
myCallbackFunction();
Or even this way:
___grecaptcha_cfg.clients[0].aa.l.callback();
Sometimes it is required to provide an argument and in most cases you should put the token there. For example:
myCallbackFunction('TOKEN');
reCAPTCHA V2 also has an invisible version.
You may check how it looks like here: https://www.google.com/recaptcha/api2/demo?invisible=true
We added parameter invisible=1
that should be used for invisible reCAPTCHA.
Invisible reCAPTCHA is located on a DIV layer positioned -10 000 px from top that makes it invisible for user.
reCAPTCHA is activated on page load or on user's actions like click somewhere or submit a form - that depends on the website. If user's cookies are good enough then he will just pass it utomatically and no additional actions will be required. Otherwise user will see standard eCAPTCHA form with a challenge.
In most cases when challenge is completed a callback function is executed. You can read more about callback here.
If you are still not sure — there are few ways to determine that reCAPTCHA is in invisible mode:
size=invisible
___grecaptcha_cfg.clients[0].aa.l.size
is equal to invisible
How to bypass invisible reCAPTCHA in browser?
Method 1: using javascript:
document.getElementById("g-recaptcha-response").innerHTML="TOKEN_FROM_10captcha";
Execute the action that needs to be performed on the page after solving reCAPTCHA.
Usually there's a form that should be submitted and you need to identify the form by id or name or any other attribute and then submit the form. Here are few examples:
document.getElementById("recaptcha-demo-form").submit(); //by id "recaptcha-demo-form" document.getElementsByName("myFormName")[0].submit(); //by element name "myFormName" document.getElementsByClassName("example").submit(); //by class name "example"
Or sometimes there's a callback function executed when reCAPTCHA is solved.
Callback function is usually defined in data-callback
parameter of reCAPTCHA, for example:
data-callback="myCallbackFunction"
Or sometimes it's defined as callback
parameter of
grecaptcha.render
function, for example:
grecaptcha.render('example', { 'sitekey' : 'someSitekey', 'callback' : myCallbackFunction, 'theme' : 'dark' });
And all you have to do is to call that function:
myCallbackFunction();
Method 2: changing HTML:
Where %g-recaptcha-response% - is an answer token you’ve got from our service.
List of GET/POST request parameters for https://ocr.10captcha.com/in.php
Parameter | Type | Required | Description |
key | String | Yes | your API key |
method | String | Yes | userrecaptcha - defines that you're sending a reCAPTCHA V2 with new method |
googlekey | String | Yes | Value of k or data-sitekey parameter you found on page |
pageurl | String | Yes | Full URL of the page where you see the reCAPTCHA |
domain | String Default: google.com |
No | Domain used to load the captcha: google.com or recaptcha.net |
invisible | Integer Default: 0 |
No | 1 - means that reCAPTCHA is invisible. 0 - normal reCAPTCHA. |
data-s | String | No | Value of data-s parameter you found on page. Curenttly applicable for Google Search and other Google services. |
cookies | String | No | Your cookies that will be passed to our OCR server who solve the captha. We also return OCR server's cookies in the response if you use json=1 .Format: KEY:Value, separator: semicolon, example: KEY1:Value1;KEY2:Value2;
|
userAgent | String | No | Your userAgent that will be passed to our OCR server and used to solve the captcha. |
header_acao | Integer Default: 0 |
No | 0 - disabled 1 - enabled. If enabled in.php will include Access-Control-Allow-Origin:* header in the response.Used for cross-domain AJAX requests in web applications. Also supported by res.php .
|
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
proxy | String | No | Format: login:[email protected]:3128 You can find more info about proxies here. |
proxytype | String | No | Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5. |
List of GET request parameters for https://ocr.10captcha.com/res.php
GET parameter | Type | Required | Description |
key | String | Yes | your API key |
action | String | Yes | get - get the asnwer for your captcha |
id | Integer | Yes | ID of captcha returned by in.php. |
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
Request URL example:
https://ocr.10captcha.com/res.php?key=347bc2896fc1812d3de5ab56a0bf4ea7&action=get&id=123456789
reCAPTCHA V3 is the newest type of captcha from Google. It has no challenge so there is no need for user interaction. Instead it uses a "humanity" rating - score.
reCAPTCHA V3 technically is quite similar to reCAPTCHA V2: customer receives a token from reCAPTCHA API which is then sent inside a POST request to the target website and verified via reCAPTCHA API.
The difference is now reCAPTCHA API returns rating of a user detecting whether he was a real human or a bot. This rating is called score and could be a number from 0.1 to 0.9. his score is passed to the website which then decides what to do with the user request.
Also there is a new parameter action allowing to process user actions on the website differently. After the verification of token reCAPTCHA API returns the name of the action user performed.
How to solve reCAPTCHA V3 using 10captcha:
First you've got to be sure the target website is actually using reCAPTCHA V3
There should be V3 if:
To start solving reCAPTCHA V3 using our API first you've got to find three
parameters:
sitekey - this parameter could be obtained from the URI of api.js as a value of render parameter. It could also be found inside URI of iframe with reCAPTCHA, in javascript code of the website where it's calling grecaptcha.execute function or in ___grecaptcha_cfg configuration object.
action - you've got to find this inspecting javascript code of the website looking for call of grecaptcha.execute function. Example:
grecaptcha.execute(6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE , {action:do_something}).
pageurl - full URL of the page where you see the reCAPTCHA V3.
Now you need to understand the score you need to solve V3. You can't predict what score is acceptable for the website you want to solve at. It can only be figured out by trial and error. The lowest score is 0.1 which means "robot", the highest is 0.9 which means "human". But most sites uses thresholds from 0.2 to 0.5 because real humans receive a low score oftenly. Our service is able to provide solutions which requires the score of 0.3. Higher score is extreamly rare.
Having all necessary parameters stated above you may send request to our API.
Submit a HTTP GET or POST request to our API URL:
https://ocr.10captcha.com/in.php
with method set to
userrecaptcha and version set to v3 along with
min_score set to score website requires, sitekey inside
googlekey parameter and full page URL as value for pageurl.
You have to include action parameter to or else we will use default
value verify.
List of request parameters below.
URL request sample:
https://ocr.10captcha.com/in.php?key=347bc2896fc1812d3de5ab56a0bf4ea7&method=userrecaptcha&version=v3&action=verify&min_score=0.3&googlekey=6LfZil0UAAAAAAdm1Dpzsw9q0F11-bmervx9g5fE&pageurl=https://mysite.com/page/
If everything is fine server will return the ID of your captcha as plain text,like: OK|123456789 or as JSON {"status":1,"request":"123456789"} if json parameter was used.
If something went wrong server will return an error. See Error Handling chapter for the list of errors.
Make a 10-15 seconds timeout and submit a HTTP GET request to our API
https://ocr.10captcha.com/res.php
providing the captcha ID. The list of parameters is in the table below.
If everything is fine and your captcha is solved server will return the answer as plain text or as JSON. The answer is a token like this:
03AHJ_Vuve5Asa4koK3KSMyUkCq0vUFCR5Im4CwB7PzO3dCxIo11i53epEraq-uBO5mVm2XRikL8iKOWr0aG50sCuej9bXx5qcviUGSm4iK4NC_Q88flavWhaTXSh0VxoihBwBjXxwXuJZ-WGN5Sy4dtUl2wbpMqAj8Zwup1vyCaQJWFvRjYGWJ_TQBKTXNB5CCOgncqLetmJ6B6Cos7qoQyaB8ZzBOTGf5KSP6e-K9niYs772f53Oof6aJeSUDNjiKG9gN3FTrdwKwdnAwEYX-F37sI_vLB1Zs8NQo0PObHYy0b0sf7WSLkzzcIgW9GR0FwcCCm1P8lB--gf50q5BMkiRH7osm4DoUgsjc_XyQiEmQmxl5sqZP7aKsaE-EM00x59XsPzD3m3YI6SRCFRUevSyumBd7KmXE8VuzIO9lgnnbka4-eZynZa6vbB9cO3QjLH0xSG3--o-fxrOuphwfrtwvvi2FGfpTexWvxhqWICMFTTjFBCEGEgj7_IFWEKirXW2RTZCVF0Gid7EtIsoEeZkPbrcUISGmgtiJkJ_KojuKwImF0G0CsTlxYTOU2sPsd5o1JDt65wGniQR2IZufnPbbK76Yh_KI2DY4cUxMfcb2fAXcFMc9dcpHg6f9wBXhUtFYTu6pi5LhhGuhpkiGcv6vWYNxMrpWJW_pV7q8mPilwkAP-zw5MJxkgijl2wDMpM-UUQ_k37FVtf-ndbQAIPG7S469doZMmb5IZYgvcB4ojqCW3Vz6Q
If the captcha is not solved yet server will return CAPCHA_NOT_READY.Just repeat your request in 5 seconds.
If something went wrong server will return an error. See Error Handling chapter for the list of errors.
Sample request:
https://ocr.10captcha.com/res.php?key=347bc2896fc1812d3de5ab56a0bf4ea7&action=get&json=1&id=123456789
After receiving the token from our API you've got to use it properly on the target website. Best way to understant that is to check the requests sent to site when you act as a normal user. Most browsers has developer's console tool where you should check Network tab.
Usually token is sent using POST request. It could be g-recaptcha-response just like reCAPTCHA V2 does or g-recaptcha-response-100000. It could be other parameter too. So you'vegot to inspect the requests and find out how exactly the token supposed to be sent. Then you have to compose your request accordingly.
List of GET/POST request parameters for https://ocr.10captcha.com/in.php
Parameter | Type | Required | Description |
key | String | Yes | your API key |
method | String | Yes | userrecaptcha — defines that you're sending a reCAPTCHA |
version | String | Yes | v3 — defines that you're sending a reCAPTCHA V3 |
googlekey | String | Yes | Value of sitekey parameter you found on page |
pageurl | String | Yes | Full URL of the page where you see the reCAPTCHA |
domain | String Default: google.com |
No | Domain used to load the captcha: google.com or recaptcha.net |
action | String Default: verify |
No | Value of action parameter you found on page |
min_score | Integer Default: 0.4 |
No | The score needed for resolution. Currently it's almost impossible to get token with score higher than 0.3 |
header_acao | Integer Default: 0 |
No | 0 — disabled 1 — enabled. If enabled in.php will include Access-Control-Allow-Origin:*: header in the
response.Used for cross-domain AJAX requests in web applications. Also supported by res.php .
|
json | Integer Default: 0 |
No | 0 — server will send the response as plain text 1 — tells the server to send the response as JSON |
List of GET request parameters for https://ocr.10captcha.com/res.php
GET parameter | Type | Required | Description |
key | String | Yes | your API key |
action | String | Yes | get — get the asnwer for your captcha reportgood — - report the asnwer was accepted reportbad — - report the asnwer was declined |
id | Integer | Yes | ID of captcha returned by in.php. |
json | Integer Default: 0 |
No | 0 — server will send the response as plain text 1 — tells the server to send the response as JSON |
header_acao | Integer Default: 0 |
No | 0 — disabled 1 — enabled. If enabled res.php will include Access-Control-Allow-Origin:* header in the response. Used for cross-domain AJAX requests in web applications. |
hCaptcha is a quite new type of captcha that is really similar to reCAPTCHA and looks like this:
Solving hCaptcha is pretty simple:
Find the value of data-sitekey parameter in the source code of the page.
Submit a HTTP GET or POST request to our API URL:
http://ocr.10captcha.com/in.php
with method set to hcaptcha and
provide the value found on previous step as value for sitekey and full page
URL as value for pageurl.
You can find the full list of
parameters in the table below.
Request URL example:
http://ocr.10captcha.com/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=hcaptcha&sitekey=10000000-ffff-ffff-ffff-000000000001&pageurl=http://mysite.com/register
If everything is fine server will return the ID of your captcha as plain text, like:
OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if
json parameter was used.
Otherwise server will return an error code.
Make a 15-20 seconds timeout then submit a HTTP GET request to our API URL:
http://ocr.10captcha.com/res.php
to get the result.
The full list of parameters is in the table below.
If captcha is already solved server will respond in plain text or JSON and return the answer token that looks like:
P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V5IjoiNGQ3MTI5ZmUtOTQxZi00NGQ4LWI5MzYtMzAwZjUyMmM3Yzc2IiwiZXhwIjoxNTY4MTA3MjY4LCJzaGFyZF9pZCI6MzAyMzQ1NDg4fQ.yJuANPBc1uzCw9tW6CoLqiijBgh6zF00KdsnqaJtugg
If captcha is not solved yet server will return CAPCHA_NOT_READY result.
Repeat
your request in 5 seconds.
If something went wrong server will return an error code.
Place the token into h-captcha-response and g-recaptcha-response
hidden elements and submit the form.
Please note, hcaptcha also has a callback. If there is no form to submit you MUST
explore the website code and find the callback.
List of GET/POST request parameters for http://ocr.10captcha.com/in.php
Parameter | Type | Required | Description |
key | String | Yes | your API key |
method | String | Yes | hcaptcha - defines that you're sending hCaptcha |
sitekey | String | Yes | Value of data-sitekey parameter you found on page |
pageurl | String | Yes | Full URL of the page where you bypass the captcha |
invisible | Number Default: 0 |
No | Use 1 for invisible version of hcaptcha. Currently it is a very rare case. |
domain | String Default: hcaptcha.com |
No | Domain used to load the captcha: hcaptcha.com or js.hcaptcha.com |
data | String | No | Custom data that is used in some implementations of hCaptcha, mostly with
invisible=1 . In most cases you see it as rqdata inside
network requests.
IMPORTANT: you MUST provide userAgent if you
submit captcha with data paramater. The value should match the
User-Agent you use when interacting with the target website.
|
userAgent | String | No | Your userAgent that will be passed to our OCR server and used to solve the
captcha. Required for hCaptcha with data parameter.
|
header_acao | Integer Default: 0 |
No | 0 - disabled 1 - enabled. If enabled in.php will include
Access-Control-Allow-Origin:* header in the response.Used for cross-domain AJAX requests in web applications. Also supported by res.php .
|
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
proxy | String | No | Format: login:[email protected]:3128 You can find more info about proxies here. |
proxytype | String | No | Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5. |
List of GET request parameters for http://ocr.10captcha.com/res.php
GET parameter | Type | Required | Description |
key | String | Yes | your API key |
action | String | Yes | get - get the asnwer for your captcha |
id | Integer | Yes | ID of captcha returned by in.php. |
json | Integer Default: 0 |
No | 0 - server will send the response as plain text 1 - tells the server to send the response as JSON |
Request URL example:
http://ocr.10captcha.com/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149
Our API allows you to set the language of captcha with lang
parameter.
The list of supported languages is available in the table below.
Language code (lang value) |
Language |
en | English |
ru | Russian |
es | Spanish |
pt | Portuguese |
uk | Ukrainian |
vi | Vietnamese |
fr | French |
id | Indonesian |
ar | Arab |
ja | Japanese |
tr | Turkish |
de | German |
zh | Chinese |
fil | Philippine |
pl | Polish |
th | Thai |
it | Italian |
nl | Nederlands (Dutch) |
sk | Slovak |
bg | Bulgarian |
ro | Romanian |
hu | Hungarian (Magyar) |
ko | Korean |
cs | Czech |
az | Azerbaijani |
fa | Persian (Farsi) |
bn | Bengali |
el | Greek |
lt | Lithuanian |
lv | Latvian |
sv | Swedish |
sr | Serbian |
hr | Croatian |
he | Hebrew |
hi | Hindi |
nb | Norwegian |
sl | Slovenian |
da | Danish |
uz | Uzbek |
fi | Finnish |
ca | Catalan |
ka | Georgian |
ms | Malay |
te | Telugu |
et | Estonian |
ml | Malayalam |
be | Belorussian |
kk | Kazakh |
mr | Marathi |
ne | Nepali |
my | Burmese |
bs | Bosnian |
hy | Armenian |
mk | Macedonian |
pa | Punjabi (Punjabi) |
Please note that we disable this option by default to get better results, please contact support if you know you want to open it for your account.
Proxies can be used to solve most types of javascript-based captchas:
Proxy allows to solve the captcha from the same IP address as you load the page.
Using proxies is not obligatory in most cases. But for some kind of protection you should use it. For example: Cloudflare and Datadome protection pages require IP matching.
Proxies are not supported for reCAPTCHA V3 as proxies dramatically decrease the success rate for this types of captcha.
If you send us the proxy, we check it's availability trying to open the website through you proxy, and if we can't do that we will not use your proxy.
If we're able to use your proxy - we'll load the reCAPTCHA through it for solving.
We support the following proxy types: SOCKS4, SOCKS5, HTTP, HTTPS with authentication by IP address or login and password.
If your proxy uses login/password authentication you have to include your credentials in proxy parameter.
POST parameter | Type | Required | Description |
proxy | String | No | Format for IP authentication: IP_address:PORT Example: proxy=123.123.123.123:3128 Format for login/password authentication: login:password@IP_address:PORT Example: proxy=proxyuser:[email protected]:3128 |
proxytype | String | No | Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5. Example: proxytype=SOCKS4 |
Please note that we disable this option by default to get better results, please contact support if you know you want to open it for your account.
Our API provides extended Cookies support for reCAPTCHA V2.
You can provide your cookies using the format below as the value of json_cookies
parameter. We will set the cookies on our OCR server's browser.
After the captcha was solved succesfully, we will return all the cookies set for domains: google.com
and the domain of your target website from pageurl
parameter value.
You should use json=1
parameter in your request to res.php endpoint to get the
cookies.
{
"json_cookies": [
{
"name": "my-cookie-name-1",
"value": "my-cookie-val-1",
"domain": "example.com",
"hostOnly": true,
"path": "\/",
"secure": true,
"httpOnly": false,
"session": false,
"expirationDate": 1665434653,
"sameSite": "strict"
},
{
"name": "my-cookie-name-2",
"value": "my-cookie-val-2",
"domain": ".google.com",
"hostOnly": false,
"path": "\/",
"secure": true,
"httpOnly": false,
"session": false,
"expirationDate": 1668015805.8028,
"sameSite": "no_restriction"
}
]
}
The following properties are required for each cookie:
domain
(String) - the domain for cookiename
(String) - the cookie namevalue
(String) - the cookie valuesecure
(Boolean) - should we set secure attribute?It's very important to use proper error handling in your code to avoid suspension of your account and service interruption.
Normally if something is wrong with your request server will return an error.
Below you can find tables with lists of errors with descriptions:
Errors can be returned as plain text or as JSON if you provided json=1 parameter.
In very rare cases server can return HTML page with error text like 500 or 502 - please keep it in mind and handle such cases correctly.
If you received anything that doesn't looks like the answer or error code - make a 5 seconds timeout and then retry your request.
Error code | Description | Action |
ERROR_WRONG_USER_KEY | You've provided key parameter value in incorrect format, it should contain 32 symbols. | Stop sending requests. Check your API key. |
ERROR_KEY_DOES_NOT_EXIST | The key you've provided does not exists. | Stop sending requests. Check your API key. |
ERROR_ZERO_BALANCE | You don't have free threads. | Send less captchas at a time or upgrade your plan. |
ERROR_PAGEURL | pageurl parameter is missing in your request. | Stop sending requests and change your code to provide valid pageurl parameter. More info. |
ERROR_ZERO_CAPTCHA_FILESIZE | Image size is less than 100 bytes. | Check the image file. |
ERROR_TOO_BIG_CAPTCHA_FILESIZE | Image size is more than 100 kB. | Check the image file. |
ERROR_WRONG_FILE_EXTENSION | Image file has unsupported extension. Accepted extensions: jpg, jpeg, gif, png. | Check the image file. |
ERROR_IMAGE_TYPE_NOT_SUPPORTED | Server can't recognize image file type. | Check the image file. |
ERROR_UPLOAD | Server can't get file data from your POST-request. That happens if your POST-request is malformed or base64 data is not a valid base64 image. |
You got to fix your code that makes POST request. |
IP_BANNED | Your IP address is banned due to many frequent attempts to access the server using wrong authorization keys. | Ban will be automatically lifted after 5 minutes. |
ERROR_BAD_TOKEN_OR_PAGEURL | You can get this error code when sending reCAPTCHA V2. That happens if your request contains invalid pair of googlekey and pageurl. The common reason for that is that reCAPTCHA is loaded inside an iframe hosted on another domain/subdomain. | Explore code of the page carefully to find valid pageurl and sitekey values. |
ERROR_GOOGLEKEY | You can get this error code when sending reCAPTCHA V2. That means that sitekey value provided in your request is incorrect: it's blank or malformed. | Check your code that gets the sitekey and makes requests to our API. |
ERROR_WRONG_GOOGLEKEY | googlekey parameter is missing in your request |
Check your code that gets the sitekey and makes requests to our API. |
ERROR_CAPTCHAIMAGE_BLOCKED | You've sent an image that is marked in our database as unrecognizable. Usually that happens if the website where you found the captcha stopped sending you captchas and started to send "deny access" image. |
Try to override website's limitations. |
ERROR_BAD_PARAMETERS | The error code is returned if some required parameters are missing in your request or the values have incorrect format. | Check that your request contains all the required parameters and the values are in proper format. |
ERROR_BAD_PROXY | You can get this error code when sending a captcha via proxy server which ismarked as BAD by our API. | Use a different proxy server in your requests. |
ERROR_SERVER_ERROR | Something went worng with our server. | Try again after 10 seconds. |
ERROR_INTERNAL_SERVER_ERROR | Something went worng with our captcha processing servers. | Try again after 10 seconds. |
Error code | Description | Action |
CAPCHA_NOT_READY | Your captcha is not solved yet. | Make 5 seconds timeout and repeat your request. |
ERROR_CAPTCHA_UNSOLVABLE | We are unable to solve your captcha it may be not supported. | Check if supported & you can retry to send your captcha. |
ERROR_WRONG_USER_KEY | You've provided key parameter value in incorrect format, it shouldcontain 32 symbols. | Stop sending requests. Check your API key. |
ERROR_KEY_DOES_NOT_EXIST | The key you've provided does not exists. | Stop sending requests. Check your API key. |
ERROR_WRONG_ID_FORMAT | You've provided captcha ID in wrong format. The ID can contain numbers only. | Check the ID of captcha or your code that gets the ID. |
ERROR_WRONG_CAPTCHA_ID | You've provided incorrect captcha ID. | Check the ID of captcha or your code that gets the ID. |
ERROR_EMPTY_ACTION | Action parameter is missing or no value is provided for action parameter. |
Check your request parameters and add the neccessary value, e.g. get or getbalance . |
ERROR_PROXY_CONNECTION_FAILED |
You can get this error code if we were unable to load a captcha through your proxy server. The proxy will be marked as BAD by our API and we will not accept requests with the proxy during 10 minutes. You will recieve ERROR_BAD_PROXY code from in.php API endpoint in such case. |
Use a different proxy server in your requests. |
ERROR_INTERNAL_SERVER_ERROR | Something went worng with our captcha processing servers. | Try again after 10 seconds. |