2Captcha compatibility

in.php and res.php for 2Captcha and RuCaptcha clients: parameters, answers, task type mapping and error codes.

Questa sezione è mostrata in inglese.

In questa pagina

in.php — create a task
Which task type is created
res.php — results, balance, reports
Error codes

in.php and res.php take the same keys and create the same tasks as the JSON API. Use GET or POST (query string or form fields). The answer is plain text, or JSON with json=1; the HTTP status is always 200.

in.php — create a task#

ParametroDescrizione

key stringobbligatorio: Your API key.
method stringobbligatorio: userrecaptcha.
googlekey stringobbligatorio: Site key (websiteKey).
pageurl stringobbligatorio: Page address (websiteURL).
version string: v3 for reCAPTCHA v3.
enterprise string: 1 for reCAPTCHA Enterprise.
invisible string: 1 for invisible reCAPTCHA v2.
action string: v3 action (pageAction).
min_score number: Minimum v3 score (minScore).
data-s string: recaptchaDataSValue.
userAgent string: User-Agent of your browser.
cookies string: KEY:Value;KEY2:Value2 (converted to KEY=Value; KEY2=Value2).
domain string: google.com or recaptcha.net.
proxy string: login:password@host:port or host:port.
proxytype string: HTTP, HTTPS, SOCKS4 or SOCKS5.
soft_id integer: Developer program id (softId).
pingback string: Webhook URL (callbackUrl), see Webhooks.
json string: 1 — answer in JSON.
header_acao string: 1 — add Access-Control-Allow-Origin: * to the answer.

in.php

curl -s "https://neurocaptcha.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-&pageurl=https://www.google.com/recaptcha/api2/demo"
# → OK|7781

curl -s "https://neurocaptcha.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-&pageurl=https://www.google.com/recaptcha/api2/demo&json=1"
# → {"request":"7781","status":1}

Which task type is created#

version	enterprise	proxy	Task type
—	—	—	`RecaptchaV2TaskProxyless`
—	—	yes	`RecaptchaV2Task`
—	`1`	—	`RecaptchaV2EnterpriseTaskProxyless`
—	`1`	yes	`RecaptchaV2EnterpriseTask`
`v3`	—	any	`RecaptchaV3TaskProxyless` (proxy ignored)
`v3`	`1`	—	`RecaptchaV3EnterpriseTaskProxyless`
`v3`	`1`	yes	`RecaptchaV3EnterpriseTask`

res.php — results, balance, reports#

action	Parameters	Answer
`get`	`id`	`OK\|<token>` or `CAPCHA_NOT_READY`; with `json=1`: `{"request":"<token>","status":1,"useragent":"…"}`
`get`	`ids=1,2,3` (up to 100)	answers in the same order, joined by `\|`: `<token>\|CAPCHA_NOT_READY\|ERROR_…`
`get2`	`id`	`OK\|<token>\|<cost>`; with `json=1` the cost is in `price`
`getbalance`	—	balance in USD, e.g. `12.3456`
`reportbad`, `reportgood`	`id`	`OK_REPORT_RECORDED` — same rules as reports

res.php

curl -s "https://neurocaptcha.com/res.php?key=YOUR_API_KEY&action=get&id=7781"
# → CAPCHA_NOT_READY, then OK|03AFcWeA6Z3vq0VhGm1oS8r0bAxKk4…

curl -s "https://neurocaptcha.com/res.php?key=YOUR_API_KEY&action=getbalance&json=1"
# → {"request":"12.3456","status":1}

Poll res.php every 2–3 seconds; the token is kept for the same time as in the JSON API.

Error codes#

Errors come as text (ERROR_…) or as {"request":"ERROR_…","status":0} with json=1. Some JSON-API codes get their 2Captcha names:

JSON API	in.php / res.php
`ERROR_NO_SUCH_CAPCHA_ID`	`ERROR_WRONG_CAPTCHA_ID`
`ERROR_TASK_ABSENT`, `ERROR_TASK_NOT_SUPPORTED`, `ERROR_NO_SUCH_METHOD`	`ERROR_BAD_PARAMETERS`
`ERROR_RECAPTCHA_TIMEOUT`	`ERROR_CAPTCHA_UNSOLVABLE`
`ERROR_PROXY_CONNECT_REFUSED`, `ERROR_PROXY_CONNECT_TIMEOUT`, `ERROR_PROXY_READ_TIMEOUT`, `ERROR_PROXY_BANNED`, `ERROR_PROXY_NOT_AUTHORISED`	`ERROR_PROXY_CONNECTION_FAILED`
`ERROR_INTERNAL`	`ERROR_INTERNAL_SERVER_ERROR`

Code	When
`ERROR_WRONG_USER_KEY`	`key` is empty
`ERROR_BAD_PARAMETERS`	`method` is not `userrecaptcha`, unknown `action`, more than 100 `ids`
`ERROR_GOOGLEKEY`	`googlekey` is missing
`ERROR_PAGEURL`	`pageurl` is missing
`ERROR_BAD_PROXY`	`proxy` or `proxytype` cannot be parsed
`ERROR_WRONG_CAPTCHA_ID`	`id` is not a positive number, or there is no such task

Other codes (ERROR_KEY_DOES_NOT_EXIST, ERROR_ZERO_BALANCE, ERROR_NO_SLOT_AVAILABLE, ERROR_TOO_MUCH_REQUESTS, ERROR_CAPTCHA_UNSOLVABLE…) are passed as they are — see Errors.