Skip to content

How to send a picture for recognition.

List of supported tasks:

Solve Media, Facebook, Yandex, Steam, VKontakte, BotDetect, Google, HotMail, Avito and more than 100,000 other types.

How to choose the right neural network for your type of captcha:

logo
Choose a neural network that is perfect for your type of captcha on the page https://captcha.guru/en/my/settings /
The changes will take effect within 5 minutes.

Method OLD is the most versatile method, suitable for any type of captcha, the percentage of recognition is lower than that of special ones.
General v1 is a general captcha recognition method, with more accurate recognition of some subspecies.
individual_v1 - Similar to the previous method, but more accurate to numeric captchas.
General Cyrillic is a general method for Cyrillic captchas.

Request example

http://api.cap.guru/in.php

ParameterTypeRequiredDescription
keyStringYes[The key can be viewed here](https://captcha.guru /)
methodStringYespost — indicates that you are sending an image using multipart-thomas
base64 — indicates that you are sending an image in base64 format
fileFileYes*Image file.
* - required if you send the image as a file (method=post)
bodyStringYes*Image encoded in Base64 format,
* - required if you send the image to Base64 (method=base64)
jsonNumber
By default: 0
No0 - The server will send a response in plain text
1 - The server will send a response in JSON format
vernetNumberNo2 - General v1
6 - General v2
22 - Arithmetic
12 - Rambler
18 - General Yandex
20 - Yandex, 6 ch.
16 - VKontakte
14 - SolveMedia
13 -Gibdd
9 - Ok.ru
17 - World of Tanks
5 - Microsoft Hotmail

Example: vernet=5
Request/response example

Request example

text
POST  http://api.cap.guru/in.php
Host: api.cap.guru
Content-Type: application/json
json
{
  "key": "YOUR_API_KEY",
  "method": "base64",
  "body": "R0lGODlheAAoAAAAACwAAAAAeAAoAIcAAAAAADMAAGYAAJkAAMwAAP8AKwAAKzMAK2YAK5kAK8wAK/8AVQAAVTMAVWYAVZkAVcwAVf8AgAAAgDMAgGYAgJkAgMwAgP8AqgAAqjMAqmYAqpkAqswAqv8A1QAA1TMA1WYA1ZkA1cwA1f8A/wAA/zMA/2YA/5kA/8wA//8zAAAzADMzAGYzAJkzAMwzAP8zKwAzKzMzK2YzK5kzK8wzK/8zVQAzVTMzVWYzVZkzVcwzVf8zgAAzgDMzgGYzgJkzgMwzgP8zqgAzqjMzqmYzqpkzqswzqv8z1QAz1TMz1WYz1Zkz1cwz1f8z/wAz/zMz/2Yz/5kz/8wz//9mAABmADNmAGZmAJlmAMxmAP9mKwBmKzNmK2ZmK5lmK8xmK/9mVQBmVTNmVWZmVZlmVcxmVf9mgABmgDNmgGZmgJlmgMxmgP9mqgBmqjNmqmZmqplmqsxmqv9m1QBm1TNm1WZm1Zlm1cxm1f9m/wBm/zNm/2Zm/5lm/8xm//+ZAACZADOZAGaZAJmZAMyZAP+ZKwCZKzOZK2aZK5mZK8yZK/+ZVQCZVTOZVWaZVZmZVcyZVf+ZgACZgDOZgGaZgJmZgMyZgP+ZqgCZqjOZqmaZqpmZqsyZqv+Z1QCZ1TOZ1WaZ1ZmZ1cyZ1f+Z/wCZ/zOZ/2aZ/5mZ/8yZ///MAADMADPMAGbMAJnMAMzMAP/MKwDMKzPMK2bMK5nMK8zMK//MVQDMVTPMVWbMVZnMVczMVf/MgADMgDPMgGbMgJnMgMzMgP/MqgDMqjPMqmbMqpnMqszMqv/M1QDM1TPM1WbM1ZnM1czM1f/M/wDM/zPM/2bM/5nM/8zM////AAD/ADP/AGb/AJn/AMz/AP//KwD/KzP/K2b/K5n/K8z/K///VQD/VTP/VWb/VZn/Vcz/Vf//gAD/gDP/gGb/gJn/gMz/gP//qgD/qjP/qmb/qpn/qsz/qv//1QD/1TP/1Wb/1Zn/1cz/1f///wD//zP//2b//5n//8z///8AAAAAAAAAAAAAAAAI/wD3CRxIsKDBgwgTKlzIsKHDhxAjSpxIsaLFixgzatzIsaPHjyBDihxJsqTJkyYzoclELFMmlDA/igFAs2bNlyDRTLpxMAYAjmhs4uR4w6ZRADEsKgPA0yDNpE5/Zsx0lObQgsoWijlY9ahFmlxpZi0IFuOkrmINnm2KEMDWgj7L7ss0s+bbiTTvCqRKc0XBoGMvHl1q0+BMNAmL6hVYmCCxxnjlMoY8WarAujURN7RLkLJAn1B7IjUY13JnAFcjrpC8r7RpxoFd53VYM+rr1qMRxg3LdmDQ2xD5Bt4H1urpsXEnRX7N9zZhhQCG760dNXTku3WJyz0r9TlFyp73nf+Vftr6ZeoEuZuP+Hvg033etUOliaYl8IXc5e42aMCogRU3xFAaeaXBdZNFjwGgmXH1WEYYTl0tthBhYBG2nnZocVZQcwNhxtpykw20VFLCwWeTAaX1phCFXoUFAIBioCHGJB6ulyFNyl20n2RgcScQd8PFB11N9tV0oXwI8aUZWWipSNFvyiR42j7Q5LaUhOghRCFBHoaV2mk5MnmUhF/dN1NcUO132n0CbVlQgsCl1RZqLpKpEZyvGYVTgqm9NyRwRX2IY0If7oOZSIHSSRCLpy1WqGNZDpRfVOS5F51BboY0qZimYbZSeBseWNChTA55EIci1eWkhpa2qFBzNtJTtCqbhpL5G60ZJVjpDWQSU5qdtg1KpU3kPRoippHGxFFzaE2USaUYKhuSh65ulKy0HFX1JbbcSgRtt+CGK+645JZr7rnopqvuuuy26+678MYrb0AAOw==",
  "json": 1
}

After sending the task to us, you should receive in response 'OK|65787087' or {"status":1,"request":"65787087"} if the request is successful. Please read [the full list of possible errors] (/en/api/code_error) in case you did not receive the task number.

Response example

json
{
 "status":1,
 "request":"65787087"
}

Getting a response

http://api.cap.guru/res.php

ParameterTypeRequiredDescription
keyStringYesThe key can be viewed here
actionStringYesget — get response
idNumberYesID of captcha returned by in.php.
jsonNumber
By default: 0
No0 — the server will return a response in plain text
1 — the server will return a response in JSON format
Request/response example

Request example

text
POST  http://api.cap.guru/res.php 
Host: api.cap.guru
Content-Type: application/json
json
{
  "key": "YOUR_API_KEY",
  "action": "get",
  "id": "XXXXXXXXXXXXXXXXXX", // for example 65787087
  "json": 1
}

After sending the task to us, you should receive in response 'OK|W68HP' or {"status":1,"request":"W68HP"} if the request is successful. Please read [the full list of possible errors] (/en/api/code_error) in case you have not received a response.

Sample response

json
{
 "status":1,
 "request":"W68HP"
}

Recognition via the browser.

You can check the operation of the service and support for your type of captcha at: http://imacros2.captcha.guru/

To do this, you need to specify the API key from your personal account and select the saved captcha image.

Examples

Python

import requests
from io import BytesIO
import base64
import time

key = 'YOUR_KEY'
url = 'http://learn.captcha.guru/img/_images/ex.png'
response = requests.get(url)

ee = base64.b64encode((response.content))

payload = {'key': key, 'method': 'base64', 'body': ee}
r = requests.post("http://api.cap.guru/in.php", data=payload)

time.sleep(10)

rt = r.text.split('|')
url = 'http://api.cap.guru/res.php?key='+key+'&id='+rt[1]
print(url);
response = requests.get(url)

print(response.content)