{"auth":"clientKey (your API key) in the JSON body","base_path":"/recaptcha","docs":"https://solver.mintbin.xyz/recaptcha/","endpoints":{"GET /recaptcha/health":"Is the service up (v3.ready, v2.ready)","GET /recaptcha/whoami":"The IP address we see for you (rate limits count per IP)","POST /recaptcha/createTask":"Start a task; returns taskId","POST /recaptcha/getTaskResult":"Read a task by taskId: status processing, then ready. Poll every 2 s; results stay readable for 10 minutes","POST /recaptcha/getToken":"One call: returns the token (recommended)"},"errors":{"ERROR_CAPTCHA_UNSOLVABLE":{"applies_to":["v3","v2"],"errorId":12,"meaning":"No token this time.","what_to_do":"Retry; a second attempt often succeeds."},"ERROR_KEY_DOES_NOT_EXIST":{"applies_to":["v3","v2"],"errorId":1,"meaning":"The clientKey is missing or wrong.","what_to_do":"Send your key as clientKey in the JSON body."},"ERROR_METHOD_NOT_ALLOWED":{"applies_to":["v3","v2"],"errorId":1,"meaning":"The wrong HTTP method for this endpoint, for example a GET on getToken.","what_to_do":"Use POST with a JSON body. health and whoami take GET."},"ERROR_NO_SLOT_AVAILABLE":{"applies_to":["v3","v2"],"errorId":2,"meaning":"The service is busy or briefly unavailable.","what_to_do":"Retry in a few seconds."},"ERROR_NO_SUCH_CAPCHA_ID":{"applies_to":["v3","v2"],"errorId":1,"meaning":"Unknown taskId, or the task finished more than 10 minutes ago.","what_to_do":"Check the id; if it expired, create a new task."},"ERROR_PROXY_CONNECTION_FAILED":{"applies_to":["v3","v2"],"errorId":25,"meaning":"Could not connect through the proxy you sent.","what_to_do":"Check its address, port and login."},"ERROR_PROXY_NOT_ALLOWED":{"applies_to":["v3","v2"],"errorId":1,"meaning":"This key may not send a proxy, or per-request proxies are turned off.","what_to_do":"Use a ProxyLess task type, or a key that allows proxies."},"ERROR_RATE_LIMIT":{"applies_to":["v3","v2"],"errorId":1,"meaning":"Too many new tasks from your IP in the last minute.","what_to_do":"Back off for a few seconds, then retry."},"ERROR_RECAPTCHA_INVALID_DOMAIN":{"applies_to":["v3","v2"],"errorId":32,"meaning":"The websiteKey is not registered for the domain of websiteURL.","what_to_do":"Check websiteURL; do not retry."},"ERROR_RECAPTCHA_INVALID_SITEKEY":{"applies_to":["v3","v2"],"errorId":31,"meaning":"Google rejected the websiteKey: mistyped, or the wrong key type.","what_to_do":"Check websiteKey; do not retry."},"ERROR_RECAPTCHA_TIMEOUT":{"applies_to":["v3","v2"],"errorId":21,"meaning":"No token within timeout_s.","what_to_do":"Retry, or send a larger timeout_s."},"ERROR_TASKID_INVALID":{"applies_to":["v3","v2"],"errorId":1,"meaning":"getTaskResult was called without a taskId.","what_to_do":"Send the taskId that createTask returned."},"ERROR_TASK_ABSENT":{"applies_to":["v3","v2"],"errorId":1,"meaning":"The body has no task object.","what_to_do":"Wrap the fields in {\"clientKey\": \"...\", \"task\": {...}}."},"ERROR_TASK_INVALID":{"applies_to":["v3","v2"],"errorId":1,"meaning":"A field is missing or invalid, for example websiteURL without http(s)://, a missing pageAction or apiJs (reCAPTCHA v3), or a non-numeric timeout_s.","what_to_do":"errorDescription names the field. Fix it and send the task again."},"ERROR_TASK_TYPE_NOT_SUPPORTED":{"applies_to":["v3","v2"],"errorId":1,"meaning":"Unknown task.type, or a type this path does not serve.","what_to_do":"Use a reCAPTCHA v3 or v2 task type from these docs. Turnstile tasks go to /turnstile/getToken."},"ERROR_TOKEN_EXPIRED":{"applies_to":["v3","v2"],"errorId":33,"meaning":"The token is over 120 s old and Google no longer accepts it.","what_to_do":"Create a new task."}},"errors_reference":"https://solver.mintbin.xyz/errors","example_error":{"errorCode":"ERROR_CAPTCHA_UNSOLVABLE","errorDescription":"No token this time. Retry; a second attempt often succeeds.","errorId":12,"taskId":"3f2a..."},"example_response":{"elapsed_s":8.3,"errorId":0,"expires_in_s":119,"solution":{"gRecaptchaResponse":"03AGdBq26...long-opaque-token..."},"status":"ready","taskId":"3f2a..."},"example_response_v2":{"elapsed_s":18.4,"errorId":0,"expires_in_s":119,"solution":{"gRecaptchaResponse":"03AFcWeA5...long-opaque-token..."},"status":"ready","taskId":"9c41..."},"proxy_note":"Types without ProxyLess take proxyType, proxyAddress, proxyPort, proxyLogin, proxyPassword","public_host":"solver.mintbin.xyz","recaptcha_v2":{"answer_deadline_s":120.0,"pageAction":"not used","proxy_types":["http","https","socks5 (without login)"],"required":["websiteURL","websiteKey"],"response_fields":{"elapsed_s":"seconds this call took","expires_in_s":"seconds left before Google stops accepting the token","solution.gRecaptchaResponse":"the token (the form's g-recaptcha-response)","taskId":"the task id (opaque)"},"status":"ready","timeout_s_range":[5,270],"token_lifetime_s":120},"recaptcha_v3":{"answer_deadline_s":60.0,"apiJs":"the reCAPTCHA script URL exactly as the page loads it, query string included (api.js or enterprise.js, on google.com or recaptcha.net; any render= key must equal websiteKey). Required. Find it in DevTools > Network (filter: recaptcha)","isEnterprise":"optional; read from apiJs (enterprise.js = Enterprise). A value that contradicts apiJs is ERROR_TASK_INVALID","pageAction":"the exact action name the page sends with reCAPTCHA (e.g. login). Required; there is no default","required":["websiteURL","websiteKey","pageAction","apiJs"],"response_fields":{"elapsed_s":"seconds this call took","expires_in_s":"seconds left before Google stops accepting the token","solution.gRecaptchaResponse":"the token","taskId":"the task id (opaque)"},"status":"ready","timeout_s_range":[5,270],"token_lifetime_s":120},"request_proxy_allowed":true,"service":"recaptcha","task_types":{"ReCaptchaV2TaskProxyLess / ReCaptchaV2Task":"v2, \"I'm not a robot\" checkboxes, including image challenges. Most calls answer in 15\u201325 s; each call waits up to 120 s by default.","ReCaptchaV3HSTask / ReCaptchaV3HSTaskProxyLess":"v3, higher score, a few seconds slower: logins, sign-ups, checkouts. Recommended for v3","ReCaptchaV3Task / ReCaptchaV3TaskProxyLess":"v3, fastest, lower score"}}
