Skip to content

Solve the slider or audio CAPTCHA

POST
/captcha
curl --request POST \
--url https://dd.antibotapi.com/captcha \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{ "type": "image", "captcha_link": "https://geo.captcha-delivery.com/captcha/?initialCid=...&hash=...&cid=...&t=fe&referer=...&s=43337&e=...&dm=cd", "html": "<base64 of the captcha page>", "background_image": "<base64 of the .jpg>", "fragment_image": "<base64 of the .frag.png>", "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36", "ip_address": "203.0.113.7" }'

Send the CAPTCHA page and its challenge. Returns the URL to GET to submit the solution, and the client-hint headers to use for the rest of the session.

For the slider, set type to image and send background_image and fragment_image (leave both out when the page has no puzzle). For audio, set type to audio and send audio_challenge. When the page loads its challenge script from https://ct.captcha-delivery.com/captcha.<ver>.js, also send it as captcha_script.

x-signature
string

A request signature. Required only when signing is on for your key. See Authentication.

Media typeapplication/json
object
type
required

image for the slider, audio for the audio challenge.

string
Allowed values: image audio
captcha_link
required

The CAPTCHA URL built from the block.

string
html
required

The CAPTCHA page, Base64-encoded.

string format: byte
captcha_script

The challenge script from https://ct.captcha-delivery.com/captcha.<ver>.js, Base64-encoded. Only needed when the page loads it with <script src>.

string format: byte
background_image

The puzzle background (.jpg), Base64. image only, and only when the page has a puzzle.

string format: byte
fragment_image

The puzzle piece (.frag.png), Base64. image only, and only when the page has a puzzle.

string format: byte
audio_challenge

The audio challenge (WAV), Base64. Required when type is audio.

string format: byte
user_agent

The User-Agent for the session. Chrome on Windows. Defaults to the latest stable Chrome.

string
language

The first tag of your Accept-Language header.

string
default: en-GB
ip_address

Your proxy’s exit IP. Sets the payload’s timezone. Defaults to Europe/London.

string

Example

{
"type": "image",
"captcha_link": "https://geo.captcha-delivery.com/captcha/?initialCid=...&hash=...&cid=...&t=fe&referer=...&s=43337&e=...&dm=cd",
"html": "<base64 of the captcha page>",
"background_image": "<base64 of the .jpg>",
"fragment_image": "<base64 of the .frag.png>",
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
"ip_address": "203.0.113.7"
}

Solved.

Media typeapplication/json
object
success
required
boolean
captcha_submit_url
required

The URL to GET to submit the solution.

string
payload
required

The solution query string, already part of captcha_submit_url.

string
headers
required

Client hints (sec-ch-ua, sec-ch-ua-full-version-list and others) to send, exactly as given, on your requests for the rest of the session. The payload was built to match them.

object
key
additional properties
string

Example generated

{
"success": true,
"captcha_submit_url": "example",
"payload": "example",
"headers": {
"additionalProperty": "example"
}
}

The request is invalid, or the solve failed for a reason you can fix. error says why. Not billed.

Media typeapplication/json
object
success
required
boolean
error
required

What went wrong.

string

Example

{
"success": false
}

The API key is missing, unknown, revoked or out of balance.

Media typeapplication/json
object
success
required
boolean
error
required

What went wrong.

string

Example

{
"success": false,
"error": "x-api-key is required"
}

The site is not approved for your account. Request it from the dashboard.

Media typeapplication/json
object
success
required
boolean
error
required

What went wrong.

string

Example

{
"success": false,
"error": "site is not whitelisted for this service"
}

Something failed on our side. Retry once. Not billed.

Media typeapplication/json
object
success
required
boolean
error
required

What went wrong.

string

Example

{
"success": false
}