CaptchaNo
[ API ]

Eine API zum Captcha-Lösen
für jede Challenge

Ändern Sie das Feld type, nicht Ihre Integration. Jede unterstützte Challenge nutzt dasselbe Request- und dasselbe Response-Format.

Request
POST https://api.captchano.com/v1/solve?wait=60
Authorization: Bearer cn-YOUR_API_KEY
Content-Type: application/json

{
  "type":    "recaptcha_v2",
  "url":     "https://example.com/login",
  "sitekey": "6LcABC...",

  "proxy":     "http://user:pass@host:port",
  "userAgent": "Mozilla/5.0 ..."
}
Response
200 OK

{
  "id":        "slv_3f9c0a7e1b2d4c6e8f0a1b2c",
  "status":    "ready",
  "type":      "recaptcha_v2",
  "solution":  {
    "token":     "03AGdBq25S...",
    "userAgent": "Mozilla/5.0 ..."
  },
  "cost":      "0.00598",
  "solveTime": 12.4,
  "createdAt": 1767225600000
}

Authentifizierung

Senden Sie Ihren Schlüssel als Authorization: Bearer cn-… (oder als X-API-Key-Header). Schlüssel erstellen und widerrufen Sie im Dashboard. Schlüssel werden nur einmal angezeigt und gehasht gespeichert – bewahren Sie eine Kopie sicher auf.

Endpoints

  • POST /v1/solve – reicht eine Challenge ein. Ohne wait antwortet er mit 202, einer id und status: "solving". Mit ?wait=N (bis zu 120 Sekunden) wartet der Request, bis die Lösung fertig ist, und antwortet mit 200 – oder mit 202, falls die Lösung bei Ablauf der Wartezeit noch läuft.
  • GET /v1/task/{id} – fragt einen Task ab. Fragen Sie alle fünf Sekunden ab; der Status wechselt von solving zu ready oder failed. Eine bezahlte Lösung bleibt zehn Minuten lang abrufbar.
  • GET /v1/balance – Ihr verbleibendes Guthaben in USD.

Challenge-Typen

  • recaptcha_v2 — url, sitekey; optional: invisible. $0.00598 pro erfolgreicher Lösung.
  • recaptcha_v3 — url, sitekey; optional: action, minScore. $0.00598 pro erfolgreicher Lösung.
  • recaptcha_enterprise — url, sitekey; optional: invisible – Enterprise-Widgets im Checkbox-Stil (Score-basierte Enterprise-Schlüssel werden nicht unterstützt). $0.00598 pro erfolgreicher Lösung.
  • turnstile — url, sitekey; optional: action, cData, pageData. $0.00435 pro erfolgreicher Lösung.
  • datadome — url, challengeUrl, proxy (Pflicht), userAgent. $0.00435 pro erfolgreicher Lösung.
  • image — body (Bild als Base64). $0.003 pro erfolgreicher Lösung.

Felder, die über die Akzeptanz entscheiden

proxy erwartet einen String wie http://user:pass@host:port (http, socks4 und socks5 werden akzeptiert). Bei Token-basierten Challenges ist er optional, bei DataDome Pflicht. Den Proxy mitzugeben, über den das Token abgesendet wird, ist der wichtigste Hebel für die Akzeptanz: Ein hinter einer anderen IP erzeugtes Token ist der häufigste Grund, warum ein gültig aussehendes Token abgelehnt wird.

action und minScore gelten für Score-basiertes reCAPTCHA. Senden Sie die Action, die die Seite selbst meldet, sonst wird der Score bei der Verifizierung abgewertet. Enthält die Lösung einen userAgent, verwenden Sie ihn beim Absenden exakt so.

Fehler

Fehler enthalten einen stabilen, maschinenlesbaren code und eine Meldung für Menschen, entweder als { "error": { "code", "message" } } oder an einem Task mit status: "failed". Alles, was keine verwendbare Lösung ergeben hat, wird nicht berechnet.

  • invalid_api_key (401) — Schlüssel fehlt, ist widerrufen oder falsch.
  • insufficient_balance (402) — Das Guthaben reicht nicht für eine Lösung. Bitte aufladen.
  • unsupported_type (400 / 422) — Unbekannter type, fehlende url oder ein fehlendes Pflichtfeld.
  • invalid_sitekey (422) — Der Sitekey wurde für diese Seite abgelehnt.
  • proxy_required (422) — DataDome wurde ohne Proxy angefordert.
  • proxy_unreachable (400 / 422) — Proxy-String fehlerhaft oder der Proxy hat die Verbindung abgelehnt.
  • unsolvable (422) — Die Challenge konnte nicht gelöst werden. Nicht berechnet.
  • capacity_unavailable (503 / 422) — Vorübergehend keine Annahme von Lösungen möglich. Mit Backoff erneut versuchen.
  • task_not_found (404) — Kein Task mit dieser id in Ihrem Konto.
  • upstream_error (422) — Die Lösung konnte nicht abgeschlossen werden. Nicht berechnet.

Abrechnung

Jede ready-Response meldet ihre cost in USD, die von Ihrem Prepaid-Guthaben abgezogen wird. Fehlgeschlagene Lösungen kosten nichts. Die Preise für jeden Typ stehen auf der Preisseite.

SDKs

Die API ist reines HTTPS und JSON, ein Paket ist also nicht nötig. Wenn Sie eines bevorzugen: Die offiziellen Open-Source-SDKs decken jeden Typ, typisierte Fehler und das blockierende Warten ab: Python, Node.js und TypeScript, Go und PHP.

Beispiele

Lauffähige Beispiele für Selenium, Puppeteer, Playwright und Scrapy sowie Tool-Wrapper für KI-Agent-Frameworks finden Sie in der Doku.

Bereit zum Loslegen?

Starten Sie mit einer kostenlosen 3-tägigen Testphase und zahlen Sie danach pro erfolgreicher Lösung, wenn Ihr Traffic wächst. Für die Testphase ist keine Karte nötig.

Tarife ansehen
Sie sind ein KI-Agent? Zu den Setup-Optionen →