Popular Captcha Solver | CaptchaSonic Docs

Solve object-interaction captchas using the PopularCaptchaImage or PopularClassification task types. The questionType field determines how the challenge is processed.

Supported Modes

`questionType`	Description	Response Format
`objectClassify`	Select all matching images from a grid	`boolean[]` per image
`objectClick`	Click on the center of a target object	`{x, y}[]` coordinates
`objectDrag`	Drag puzzle pieces to their correct position	`{start, end}[]`
`objectTag`	Tag objects in an image	Labels array
`grid`	Generic grid selection	Boolean array
`bbox`	Bounding box detection	Coordinates

Create Task — Grid Classify

POST/createTask

Hostapi.captchasonic.com

Content-Typeapplication/json

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectClassify",
        "question": "Select all objects with a bridge",
        "queries": ["BASE64_IMG_1", "BASE64_IMG_2"]
    }
}

Response

{
    "code": 200,
    "msg": "",
    "answers": [true, false, true, true, false, true],
    "questionType": "objectClassify",
    "meta": { "pass_report": true, "fail_report": true }
}

Create Task — Object Click

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectClick",
        "question": "Click on the center of the car",
        "queries": ["BASE64_MAIN_IMAGE"]
    }
}

Create Task — Object Drag

{
    "apiKey": "YOUR_API_KEY",
    "task": {
        "type": "PopularCaptchaImage",
        "questionType": "objectDrag",
        "question": "Drag the puzzle piece to the gap",
        "queries": ["BASE64_BACKGROUND"],
        "examples": ["BASE64_PUZZLE_PIECE"]
    }
}

Task Parameters

Property	Type	Required	Description
`type`	`string`	✅	`PopularCaptchaImage` or `PopularClassification`
`questionType`	`string`	✅	`objectClassify`, `objectClick`, `objectDrag`, `objectTag`, `grid`, `bbox`
`question`	`string`	✅	The challenge instruction text
`queries`	`string[]`	✅	Base64-encoded images
`examples`	`string[]`	Drag only	Target objects for drag tasks
`screenshort`	`boolean`	No	Set `true` if images are screenshots

API Playground

POSTapi.captchasonic.com

Payload

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "PopularCaptchaImage",
    "questionType": "objectClassify",
    "question": "Select all objects with a bridge",
    "queries": [
      "BASE64_IMG_1",
      "BASE64_IMG_2"
    ]
  }
}

{
  "apiKey": "YOUR_API_KEY",
  "task": {
    "type": "PopularCaptchaImage",
    "questionType": "objectClassify",
    "question": "Select all objects with a bridge",
    "queries": [
      "BASE64_IMG_1",
      "BASE64_IMG_2"
    ]
  }
}

Response

Hit Send to see response

⌘ + Enter

Parameters

apiKeystringYOUR_API_KEY

taskobject{...}

└ typestringPopularCaptchaImage

└ questionTypestringobjectClassify

└ questionstringSelect all objects with a brid…

└ queriesarray[2 items]

Error Codes

1KEY_DOES_NOT_EXIST— API key is invalid or not found.

2NO_SLOT_AVAILABLE— All solver slots are occupied.

3ZERO_BALANCE— Account balance is zero.

10ERROR_BAD_PARAMETERS— Invalid or missing request fields.

12ERROR_CAPTCHA_UNSOLVABLE— Captcha could not be solved.

14PLAN_EXPIRED— Your plan has expired.

16RATE_LIMITED— Too many requests. Slow down.

17DAILY_LIMIT_EXCEEDED— Daily usage limit reached.

18QUOTA_LIMIT_EXCEEDED— Plan quota exhausted.

21SERVICE_UNAVAILABLE— Backend is temporarily unavailable.

Code

terminal