Skip to main content
ScrapingBuddy
Skip to content
ScrapingBuddyDevelopers
Dashboard
On this page List recent tasks

CAPTCHA API/Guides

List tasks & usage

Retrieve your recent tasks and account-level usage summary.

List recent tasks

GET /captcha/tasks returns tasks for the authenticated account, newest first. Each response contains up to 20 tasks, a hasMore flag and a usage summary.

Example
curl "https://www.scrapingbuddy.com/api/v1/captcha/tasks?offset=0" \
  -H "Authorization: Bearer $SCRAPINGBUDDY_API_KEY"

Load the next page

Start with offset=0. If hasMore is true, request offset=20, then 40, and so on. Stop when hasMore is false. Offset must be an integer from 0 to 100000.

This is offset pagination, not a frozen snapshot. New tasks created while you page can shift the results; deduplicate by task ID if you are collecting multiple pages.

Interpret the summary

The usage summary covers the last 30 days for your account, not only the current page of tasks. Use the CAPTCHA dashboard Usage view to inspect recent activity.

task.charge is the actual customer debit in USD, stored as a decimal string. task.cost remains the provider-reported cost for compatibility. Usage shows customer charges, excluding active reservations. Tasks created before billing was enabled have billingStatus: legacy and no customer charge. Raw uploaded files are not returned in task history.

Manage API keysExplore API reference
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.