एक captcha solving API
हर challenge के लिए

ऑथेंटिकेशन

अपनी key को Authorization: Bearer cn-… के रूप में (या X-API-Key header के रूप में) भेजें। Keys dashboard में बनाएँ और रद्द करें। Keys सिर्फ़ एक बार दिखाई जाती हैं और hashed रूप में स्टोर होती हैं, इसलिए उनकी एक कॉपी किसी सुरक्षित जगह रखें।

एंडपॉइंट

• POST /v1/solve — एक challenge submit करें। wait के बिना यह id और status: "solving" के साथ 202 लौटाता है। ?wait=N (120 सेकंड तक) के साथ request तब तक रुकी रहती है जब तक solve तैयार न हो और 200 लौटाती है, या wait ख़त्म होने पर भी solve चल रहा हो तो 202 लौटाती है।
• GET /v1/task/{id} — एक task poll करें। हर पाँच सेकंड में poll करें; status solving से ready या failed पर जाता है। भुगतान किया गया solution दस मिनट तक प्राप्त किया जा सकता है।
• GET /v1/balance — आपका बचा हुआ credit, USD में।

Challenge के प्रकार

• recaptcha_v2 — url, sitekey; वैकल्पिक invisible। हर सफल solve के लिए $0.00598।
• recaptcha_v3 — url, sitekey; वैकल्पिक action, minScore। हर सफल solve के लिए $0.00598।
• recaptcha_enterprise — url, sitekey; वैकल्पिक invisible — Enterprise checkbox-style widgets (score-आधारित Enterprise keys सपोर्टेड नहीं हैं)। हर सफल solve के लिए $0.00598।
• turnstile — url, sitekey; वैकल्पिक action, cData, pageData। हर सफल solve के लिए $0.00435।
• datadome — url, challengeUrl, proxy (ज़रूरी), userAgent। हर सफल solve के लिए $0.00435।
• image — body (base64 इमेज)। हर सफल solve के लिए $0.003।

Acceptance तय करने वाले फ़ील्ड

proxy एक string लेता है, जैसे http://user:pass@host:port (http, socks4 और socks5 स्वीकार हैं)। Token-आधारित challenges पर यह वैकल्पिक है और DataDome पर ज़रूरी। Token submit करने वाला proxy भेजना acceptance पर सबसे बड़ा असर डालता है: किसी अलग IP के पीछे बना token, मान्य दिखने वाले token के reject होने की सबसे आम वजह है।

action और minScore score-आधारित reCAPTCHA पर लागू होते हैं। वही action भेजें जो पेज खुद बताता है, वरना verification पर score घटा दिया जाता है। जब solution में userAgent शामिल हो, तो submit करते समय उसे बिल्कुल वैसा ही दोहराएँ।

एरर

Errors में एक स्थिर machine-readable code और इंसानों के लिए एक संदेश होता है, या तो { "error": { "code", "message" } } के रूप में या status: "failed" वाले task पर। जो कुछ भी इस्तेमाल लायक solution नहीं देता, वह बिल नहीं होता।

• invalid_api_key (401) — Key मौजूद नहीं, रद्द या ग़लत है।
• insufficient_balance (402) — बैलेंस एक solve के लिए भी काफ़ी नहीं है। Top up करें।
• unsupported_type (400 / 422) — अज्ञात type, url मौजूद नहीं, या कोई ज़रूरी फ़ील्ड मौजूद नहीं।
• invalid_sitekey (422) — उस पेज के लिए sitekey reject हो गई।
• proxy_required (422) — DataDome को बिना proxy के request किया गया।
• proxy_unreachable (400 / 422) — Proxy string ग़लत फ़ॉर्मेट में है या proxy ने कनेक्शन मना कर दिया।
• unsolvable (422) — Challenge solve नहीं हो सका। बिल नहीं हुआ।
• capacity_unavailable (503 / 422) — अस्थायी रूप से solves स्वीकार नहीं हो पा रहे। Backoff के साथ retry करें।
• task_not_found (404) — आपके अकाउंट पर उस id का कोई task नहीं है।
• upstream_error (422) — Solve पूरा नहीं हो सका। बिल नहीं हुआ।

बिलिंग

हर ready response अपनी cost USD में बताता है, जो आपके प्रीपेड बैलेंस से काटी जाती है। असफल solves का कोई खर्च नहीं। हर type की कीमतें pricing पेज पर हैं।

SDKs

API सादा HTTPS और JSON है, इसलिए किसी package की ज़रूरत नहीं। अगर आप चाहें, तो आधिकारिक open-source SDKs हर type, typed errors और blocking wait को wrap करते हैं: Python, Node.js और TypeScript, Go और PHP।

उदाहरण

Selenium, Puppeteer, Playwright और Scrapy के काम करते उदाहरण, और AI agent frameworks के लिए tool wrappers, docs में हैं।