Skip to main content
ScrapingBuddy
Skip to content
ScrapingBuddyDevelopers
Dashboard
On this page Introduction

Developers/CAPTCHA API

Build your CAPTCHA integration

Send a challenge. Retrieve its answer. Bring the result into your application.

The API uses the same create-and-poll workflow for each CAPTCHA type. Choose the input and result format you need, then follow its dedicated reference.

Make your first request
  1. 01
    Create

    POST a task; retain its ID.

  2. 02
    Poll

    GET the result every 6 seconds.

  3. 03
    Read

    Stop at ready or failed.

Start building

New to the API? Start with one text task. You can move to image and audio challenges once the request flow is working.

Your first taskA complete walkthrough from API key to answer.AuthenticationCreate a key and connect your backend securely.Prepare your filesUnderstand Base64, file sizes and input ordering.Polling & safe retriesWait for results without creating duplicate work.

Choose a solution

Each page explains what to send, how to interpret the answer and how to integrate it with Node.js, Python or cURL.

Click points

Coordinates CAPTCHA

Send one image and get back the x/y click points requested by your instruction.

Tile indexes

Grid CAPTCHA

Send separate tile images or one complete grid and get back the selected tile numbers.

Puzzle placement

Drag & Drop CAPTCHA

Send a background image plus puzzle pieces and get destination coordinates for each piece.

Object boxes

Bounding Box CAPTCHA

Send one image and get object boundaries as xMin, xMax, yMin, and yMax.

Image text

Normal CAPTCHA

Send a CAPTCHA image and get back the text that should be typed.

Question answer

Text CAPTCHA

Send a plain text question and get back the answer text.

Rotation angle

Rotate CAPTCHA

Send an image and get back the angle needed to rotate it into the correct position.

Audio text

Audio CAPTCHA

Send an MP3 audio CAPTCHA and get back the transcribed text.

Shared endpoints

Use https://www.scrapingbuddy.com/api/v1 as the base URL. Every request requires Bearer authentication. Task creation also requires a UUID v4 idempotency key.

MethodPathPurpose
POST/captcha/tasksCreate one CAPTCHA solving task. Requires UUID v4 Idempotency-Key.
GET/captcha/tasks/{id}Poll one task until status is ready or failed.
GET/captcha/tasks?offset=0List recent CAPTCHA tasks and 30-day usage.
List tasks & usageErrors & troubleshooting
CAPTCHA API v1
Getting startedIntroductionYour first taskAuthenticationPrepare image & audio inputs
Integration guidesPolling & safe retriesErrors & troubleshootingList tasks & usage
API keys Contact support

Explore the documentation

CAPTCHA APIIntroduction

Choose a CAPTCHA solution, create a task and retrieve its answer.

Integration guidesYour first task

Make one request, wait for the answer, and read your first result. Start with a text question so you do not need to prepare a file.

Integration guidesAuthentication

Connect your backend securely with a ScrapingBuddy API key.

Integration guidesPrepare image & audio inputs

Encode the original file correctly and stay within the limits for your solution.

Integration guidesPolling & safe retries

Follow a task to completion without creating duplicate work.

Integration guidesErrors & troubleshooting

Find out whether a request was rejected, a task failed, or you simply need to wait.

Integration guidesList tasks & usage

Retrieve your recent tasks and account-level usage summary.

CAPTCHA referenceCoordinates CAPTCHA

Send one image and get back the x/y click points requested by your instruction. Use this for image challenges where the answer is one or more points, such as “click the apple” or “

CAPTCHA referenceGrid CAPTCHA

Send separate tile images or one complete grid and get back the selected tile numbers. Use this for challenges that ask the user to select matching squares from a tiled image.

CAPTCHA referenceDrag & Drop CAPTCHA

Send a background image plus puzzle pieces and get destination coordinates for each piece. Use this for visual puzzles where one or more draggable pieces must be placed into matchi

CAPTCHA referenceBounding Box CAPTCHA

Send one image and get object boundaries as xMin, xMax, yMin, and yMax. Use this for challenges that ask the user to draw a box around an object or region.

CAPTCHA referenceNormal CAPTCHA

Send a CAPTCHA image and get back the text that should be typed. Use this for distorted image text challenges where the expected answer is a string.

CAPTCHA referenceText CAPTCHA

Send a plain text question and get back the answer text. Use this for human-readable questions, riddles, or text-only challenges that do not require an image upload.

CAPTCHA referenceRotate CAPTCHA

Send an image and get back the angle needed to rotate it into the correct position. Use this for challenges where an image must be turned until it is upright or aligned.

CAPTCHA referenceAudio CAPTCHA

Send an MP3 audio CAPTCHA and get back the transcribed text. Use this for audio challenges where the answer is the words or numbers spoken in the file.