CaptchaNo
[ INTEGRATION ]

Captcha Solver für
cURL

Lösen Sie die Challenge innerhalb des Laufs, statt den Job scheitern zu lassen. Ein lauffähiges Shell-Beispiel und die drei Faktoren, die über die Annahme Ihres Tokens entscheiden.

cURL · Shell
curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
  -H "Authorization: Bearer cn-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "type": "recaptcha_v2",
        "sitekey": "6LcABC...",
        "url": "https://example.com/login",
        "proxy": "http://user:pass@host:port"
      }'

# 200 OK
# { "id": "slv_…", "status": "ready",
#   "solution": { "token": "03AGdBq25S…" },
#   "cost": "0.00598", "solveTime": 18.4 }

Was über die Annahme des Tokens entscheidet

  1. Reichen Sie Ihren Proxy durch. Das Token sollte hinter derselben Exit-IP erzeugt werden, von der es auch abgeschickt wird. Bei sitzungsbasiert bewertenden Systemen ist das Pflicht, keine Optimierung.
  2. Verwenden Sie denselben User-Agent. Turnstile und mehrere Anti-Bot-Systeme binden das Token an einen User-Agent. Wir geben den verwendeten zurück, damit Sie ihn exakt übernehmen können.
  3. Fordern Sie spät an. Tokens laufen nach etwa 120 Sekunden ab. Fordern Sie eines erst an, wenn Sie zum Absenden bereit sind.

Blockierend oder Polling

Das Beispiel nutzt ?wait=60, sodass der Aufruf die fertige Lösung zurückgibt und Ihr cURL-Schritt linear bleibt. Wenn Sie keine Verbindung offen halten möchten, lassen Sie den Parameter weg, speichern die zurückgegebene id und fragen GET /v1/task/{id} alle fünf Sekunden ab. Ein bezahltes Token bleibt zehn Minuten lang abrufbar, eine abgebrochene Verbindung kostet Sie also nicht die Lösung.

Kosten

$0.00598 pro erfolgreicher reCAPTCHA-v2-Lösung, fehlgeschlagene Lösungen werden nie berechnet. Unter Preise finden Sie jeden Challenge-Typ, in der API-Referenz das vollständige Request-Format.

[ SO PASST ES ]

So fügt sich die Lösung in cURL ein

Die API ist reines HTTPS und JSON. Mit cURL sehen Sie daher am schnellsten eine Lösung von Anfang bis Ende, bevor Sie Code schreiben.

  1. 01
    Schlüssel erstellen

    Erstellen Sie im Dashboard einen API-Schlüssel. Er beginnt mit cn-.

  2. 02
    Lösung anfordern

    JSON mit type, sitekey und url per POST an /v1/solve?wait=60 senden, mit einem Header Authorization: Bearer.

  3. 03
    Response lesen

    status, solution.token, cost und solveTime kommen in einem JSON-Objekt zurück.

  4. 04
    Alternativ pollen

    Lassen Sie ?wait weg und fragen Sie stattdessen alle paar Sekunden GET /v1/task/{id} ab.

So kommt das Token in die Seite

Sie kopieren das Token aus der JSON-Response in das Formularfeld oder den Request, den Ihr eigener Client sendet.

[ FALLSTRICKE ]

Woran Integrationen meistens scheitern

Fehlender Content-Type

Senden Sie Content-Type: application/json, sonst wird der Body nicht geparst.

Quoting in der Shell

Setzen Sie das JSON in einfache Anführungszeichen, damit die Shell darin nichts expandiert.

[ FAQ ]

FAQ zu Captchas mit cURL

Brauche ich ein SDK?

Nein. CaptchaNo ist eine schlichte REST-API. Jeder HTTP-Client in jeder Sprache funktioniert, und mit cURL lässt sie sich am einfachsten ausprobieren.

Wie prüfe ich mein Guthaben?

Rufen Sie GET /v1/balance mit demselben Authorization-Header auf. Das Dashboard zeigt außerdem Guthaben, Nutzung und jede Lösung.

Was liefert eine fehlgeschlagene Lösung zurück?

Den Status failed mit einem Fehlercode. Fehlgeschlagene Lösungen werden nicht berechnet, Sie können also gefahrlos erneut versuchen.

Wie lange kann ich auf ein Ergebnis warten?

Der Parameter wait blockiert bis zu 120 Sekunden. Die meisten Lösungen kommen deutlich früher zurück; nutzen Sie Polling, wenn Ihr Client eine Verbindung nicht so lange offen halten kann.

[ WEITERLESEN ]

Hilfreiche Anleitungen

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 →