Solvecha

Shows the plan, the solves left today, the balance and the time until the daily reset. Free to call.

{
  "type": "object",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "description": "Plan name: a monthly plan, 'Free', 'Pay per use' or 'No plan'."
    },
    "status": {
      "type": "string"
    },
    "solves_left_today": {
      "type": "integer",
      "description": "How many more successful solves can be paid today (daily quota left plus balance)."
    },
    "daily_quota": {
      "type": "integer"
    },
    "balance_usd": {
      "type": "string"
    },
    "seconds_until_daily_reset": {
      "type": "integer",
      "description": "The daily quota resets at 00:00 UTC."
    }
  },
  "required": [
    "plan",
    "status",
    "solves_left_today",
    "daily_quota",
    "balance_usd",
    "seconds_until_daily_reset"
  ],
  "additionalProperties": false
}

Tells Solvecha whether a reCAPTCHA answer was accepted or rejected. Free, optional, and it improves accuracy.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job_id returned by solve_recaptcha_grid."
    },
    "verdict": {
      "type": "string",
      "description": "'accepted' if the site accepted the answer (the challenge was passed or the next step appeared), 'rejected' if it did not."
    },
    "grid": {
      "type": "string",
      "description": "The grid you sent: '3x3', '4x4' or '1x1'."
    },
    "round_index": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Optional: which challenge round this was, starting at 0."
    }
  },
  "required": [
    "job_id",
    "verdict",
    "grid"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "recorded": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "recorded",
    "message"
  ],
  "additionalProperties": false
}

Solves a FunCAPTCHA tile-selection puzzle (mode 'tile') or a game-style match puzzle (mode 'match') and returns which tiles to pick. Costs one credit per successful solve.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "description": "The instruction text, for example 'Pick the sheep' or 'Match the number of rocks with the number on the left'."
    },
    "image": {
      "type": "string",
      "description": "One picture: the grid of tiles (mode tile) or the whole game image (mode match). Base64 or https URL."
    },
    "mode": {
      "type": "string",
      "description": "'tile' picks tiles in a 3x2 grid (default). 'match' solves game puzzles where a picture must match a reference."
    },
    "timeout_seconds": {
      "type": "integer",
      "description": "How long to wait for the answer, 5 to 90. Default 45."
    }
  },
  "required": [
    "task",
    "image"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string"
    },
    "mode": {
      "type": "string"
    },
    "selected_tiles": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "integer"
      },
      "description": "Tiles to pick, counted from 1 (left to right, top to bottom for tile mode; in the order of the answer options for match mode)."
    },
    "answer": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  },
  "required": [
    "job_id",
    "mode",
    "selected_tiles",
    "answer"
  ],
  "additionalProperties": false
}

Solves a GeeTest slider puzzle and returns how far to drag the handle, as a percentage of the background width. Costs one credit per successful solve.

{
  "type": "object",
  "properties": {
    "images": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Either one screenshot of the whole challenge, or two pictures in this order: the background, then the transparent puzzle piece. Each is base64 or an https URL."
    },
    "task": {
      "type": "string",
      "description": "The instruction text of the challenge. Default 'slide'."
    },
    "timeout_seconds": {
      "type": "integer",
      "description": "How long to wait for the answer, 5 to 90. Default 45."
    }
  },
  "required": [
    "images"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string"
    },
    "offset_percent": {
      "type": "number",
      "description": "How far to drag the slider handle, as a percentage of the width of the background picture as shown on the page."
    },
    "how_to_use": {
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "offset_percent",
    "how_to_use"
  ],
  "additionalProperties": false
}

Solves a Google reCAPTCHA v2 image challenge from a screenshot and returns which tiles to click. Send the instruction text (task), the layout (grid) and the picture(s). Waits for the answer (usually 2 to 6 seconds). Costs one credit per successful solve. After you click and submit, call report_result with Google's verdict.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "description": "The instruction text shown to the user, copied in full, for example 'Select all images with buses'."
    },
    "grid": {
      "type": "string",
      "description": "Challenge layout: '3x3' or '4x4' (one picture of the whole grid) or '1x1' (single tile pictures, 1 to 9)."
    },
    "images": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "For 3x3 and 4x4: exactly one picture of the whole grid. For 1x1: one to nine tile pictures. Each is base64 (PNG, JPEG, GIF or WebP; a data: URL is fine) or an https URL."
    },
    "timeout_seconds": {
      "type": "integer",
      "description": "How long to wait for the answer, 5 to 90. Default 45. Solves usually take 2 to 6 seconds."
    }
  },
  "required": [
    "task",
    "grid",
    "images"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Pass this to report_result after you submit the answer."
    },
    "grid": {
      "type": "string"
    },
    "selected_tiles": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "integer"
      },
      "description": "Tiles to click, counted from 1. 3x3 and 4x4: left to right, top to bottom. 1x1: the number of the picture you sent. Empty means: click none (then press Verify or Skip)."
    },
    "positions": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "The same tiles as 'row R, column C' (3x3 and 4x4 only)."
    },
    "answer": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "boolean"
      },
      "description": "One boolean per tile: true means click it."
    },
    "summary": {
      "type": "string"
    }
  },
  "required": [
    "job_id",
    "grid",
    "selected_tiles",
    "answer",
    "summary"
  ],
  "additionalProperties": false
}

Reads a picture with distorted letters and digits and returns the text (case-sensitive). Costs one credit per successful solve.

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "The captcha picture: base64 (a data: URL is fine) or an https URL."
    },
    "timeout_seconds": {
      "type": "integer",
      "description": "How long to wait for the answer, 5 to 90. Default 45."
    }
  },
  "required": [
    "image"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string"
    },
    "text": {
      "type": "string",
      "description": "The recognised text. It is case-sensitive."
    }
  },
  "required": [
    "job_id",
    "text"
  ],
  "additionalProperties": false
}