Skip to main content
CapSolver logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: CAPSOLVER
  • Version: 00000000_00

Tools

Slug: CAPSOLVER_CLASSIFY_AWS_WAFClassify one AWS WAF challenge image or a nine-image grid and return the immediate geometric or object result. This is a paid CapSolver operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string ("aws:toycarcity:carcity" | "aws:grid:bag" | "aws:grid:bed" | "aws:grid:belts" | "aws:grid:binocular" | "aws:grid:bucket" | "aws:grid:chair" | "aws:grid:clock" | "aws:grid:cooking pot" | "aws:grid:curtain" | "aws:grid:fork" | "aws:grid:hat" | "aws:grid:scissors" | "aws:grid:seat" | "aws:grid:spoon" | "aws:grid:suitcase" | "aws:grid:umbrella")
required
Provider-documented AWS WAF challenge question identifier.
string
Optional URL of the page containing the challenge.
array
required
Base64 challenge images. Supply exactly nine images for an aws:grid question and exactly one for aws:toycarcity:carcity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_CLASSIFY_RECAPTCHA_V2Classify a reCAPTCHA v2 challenge image for a documented object category and return the immediate selection result. This is a paid CapSolver operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string ("taxis" | "bus" | "school_bus" | "motorcycles" | "tractors" | "chimneys" | "crosswalks" | "traffic_lights" | "bicycles" | "parking_meters" | "cars" | "bridges" | "boats" | "palm_trees" | "mountains_or_hills" | "fire_hydrant" | "stairs")
required
Object category named by the challenge prompt. Choose from taxis, bus (generic buses), school_bus (school buses), motorcycles, tractors, chimneys, crosswalks, traffic_lights, bicycles, parking_meters, cars, bridges, boats, palm_trees, mountains_or_hills, fire_hydrant, or stairs.
string
Optional reCAPTCHA site key associated with the challenge.
string
Optional URL of the page containing the challenge.
string
required
Base64-encoded reCAPTCHA challenge image.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_GET_BALANCEReturn the connected CapSolver account balance and non-secret package metadata. Package access tokens are never returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_GET_TASK_RESULTGet one asynchronous CapSolver task result, or optionally poll it every three seconds for a bounded time. This action never creates or retries a task.

Input Parameters

string
required
Task identifier returned by a CapSolver task-creation operation.
boolean
Poll every three seconds until the task is ready or the timeout expires. False performs exactly one result request.
integer
Window for scheduling polls (3-300 seconds). A final scheduled request may use its network timeout; then the latest state and task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_RUN_VISION_ENGINERun one documented CapSolver vision module and return its immediate points, distance, angle, rectangles, or text result. This is a paid operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string ("botdeflector" | "slider_1" | "rotate_1" | "rotate_2" | "shein" | "ocr_gif")
required
Provider module and contract: botdeflector requires image_base64 and background_image_base64 and returns points as x/y pairs; slider_1 requires both images and returns distance; rotate_1 requires both images and returns an angle; rotate_2 uses image_base64 and returns an angle; shein requires image_base64 and question and returns ordered rectangles; ocr_gif uses a base64 GIF and returns recognized text. The selected value is sent to CapSolver unchanged.
string
Challenge question. Required only for the shein module.
string
Optional URL of the page containing the visual challenge.
string
required
Raw base64 foreground or challenge image without a data-URI prefix or newlines.
string
Raw base64 background image. Required for botdeflector, slider_1, and rotate_1; optional for the other modules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_AWS_WAFCreate one AWS WAF token task with or without a caller-supplied proxy and optionally poll every three seconds for a bounded time. Returns the task ID when processing continues. This is a paid CapSolver operation.

Input Parameters

string
Caller-controlled proxy in a CapSolver-supported format. Required for variant=proxy and never returned.
string
Optional CapSolver application identifier for usage attribution.
string
Sensitive AWS WAF initialization vector from the challenge data.
string
AWS WAF key extracted from the challenge data, when available.
string ("proxyless" | "proxy")
Whether CapSolver connects directly or through the supplied proxy.
string
Sensitive AWS API JavaScript URL documented by CapSolver.
string
Sensitive challenge-specific AWS API key; never returned.
string
Sensitive AWS WAF context from the challenge data.
string
required
Full URL protected by AWS WAF.
string
Sensitive AWS WAF challenge problem URL, when available.
boolean
Wait for a ready result after creating the task; false returns the task ID immediately.
string
Sensitive challenge JavaScript URL or value documented by CapSolver.
string
Sensitive existing AWS WAF token; never returned.
integer
Window for scheduling polls. A final scheduled request may use its network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_BOTDEFLECTORCreate exactly one proxyless BotDeflector task from a target flow token and optionally poll every three seconds for a bounded time. Returns the task ID when processing continues. This is a paid CapSolver operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string
required
Domain used by the target’s pow/get or icon/get request. It may differ from website_url.
string
required
Fresh target flow token, sometimes named botReflectorJwtToken. It is sent only to CapSolver and never returned.
string
required
Full URL of the page protected by BotDeflector.
boolean
Wait for a ready result after creating the task; false returns the task ID immediately.
integer
Window for scheduling polls. A final scheduled request may use its three-second network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_CLOUDFLARE_CHALLENGECreate one Cloudflare challenge task through a sticky caller-supplied proxy and optionally poll every three seconds for bounded clearance output. This is a paid CapSolver operation.

Input Parameters

string
Fresh challenge HTML obtained through the same sticky proxy. It is sent upstream and never returned.
string
required
Static or sticky caller-controlled proxy in a CapSolver-supported format. Its session must remain stable for at least three minutes and it is never returned.
string
CapSolver application identifier for usage attribution.
string
Chrome user agent matching the client and sticky proxy session that will use the clearance result.
string
required
Full URL protected by the Cloudflare challenge.
boolean
Wait for a ready result; false returns the task ID immediately.
integer
Window for scheduling polls. A final scheduled request may use its three-second network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_CLOUDFLARE_TURNSTILECreate one proxyless Cloudflare Turnstile task and optionally poll every three seconds for a bounded time. Returns the task ID for continuation. This is a paid CapSolver operation.

Input Parameters

string
Secret Turnstile custom data value from widget metadata, when present.
string
Turnstile action value from widget metadata, when present.
string
CapSolver application identifier for usage attribution, when used.
string
required
Turnstile site key from the target page.
string
required
Full URL of the page containing the Turnstile widget.
boolean
Wait for a ready result; false returns the task ID immediately.
integer
Window for scheduling polls. A final scheduled request may use its network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_DATADOMECreate exactly one DataDome slider task with a caller-supplied proxy and optionally wait a bounded time for its solution cookie. This is a paid CapSolver operation.

Input Parameters

string
Fresh challenge HTML, sent only to CapSolver and never returned.
string
required
Caller-controlled proxy in a CapSolver-supported format. Its IP must not be banned by the target, and the value is never returned.
string
Optional CapSolver application identifier for usage attribution.
string
required
Provider-supported browser user agent that exactly matches the client which will use the returned cookie.
string
required
Fresh DataDome captcha URL with query parameter t=fe. A URL with t=bv indicates that the proxy IP is banned.
boolean
Wait for a ready result after creating the task; false returns the task ID immediately.
integer
Window for scheduling polls. A final scheduled request may use its network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_GEETESTCreate one GeeTest v3 or v4 token task and optionally poll every three seconds for a bounded time. Returns the task ID when processing continues. This is a paid CapSolver operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string ("v3" | "v4")
required
GeeTest protocol version used by the target page.
string
Fresh GeeTest v3 challenge value; required for version v3.
string
Optional GeeTest v4 risk type when required by the target.
string
GeeTest v4 captcha identifier; required for version v4.
string
required
Full URL of the page containing GeeTest.
string
GeeTest v3 site identifier. Required for version v3; obtain the provider field named gt together with challenge from the target site’s fresh GeeTest initialization request. Do not copy a stale value directly from browser developer tools.
boolean
Wait for a ready result after creating the task; false returns the task ID immediately.
string
Optional GeeTest API server subdomain used by the target.
integer
Window for scheduling polls. A final scheduled request may use its three-second network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_IMAGE_TO_TEXTRecognize text or number answers from base64-encoded images and return the immediate recognition result. This is a paid CapSolver operation.

Input Parameters

string
Optional CapSolver application identifier for usage attribution.
string ("common" | "number")
Recognition mode: common returns text; number returns answers for multiple images.
string
Optional source page URL associated with the image challenge.
string
Raw base64 image without a data-URI prefix or newlines; required when module is common.
array
One to nine raw base64 images; required when module is number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_MTCAPTCHACreate one proxyless or caller-proxied MTCaptcha token task and optionally poll every three seconds for a bounded time. Returns the task ID when processing continues. This is a paid CapSolver operation.

Input Parameters

string
Caller-controlled proxy in a CapSolver-supported format. Required for the proxy variant and never returned.
string
CapSolver application identifier for usage attribution.
string ("proxyless" | "proxy")
Whether CapSolver connects directly or through the supplied proxy.
string
required
MTCaptcha site key from the target page.
string
required
Full URL of the page containing MTCaptcha.
boolean
Wait for a ready result; false returns the task ID immediately.
integer
Window for scheduling polls. A final scheduled request may use its three-second network timeout; then processing and the task ID are returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_RECAPTCHA_V2Solve one standard or enterprise reCAPTCHA v2 challenge in task or synchronous mode. Task mode creates exactly one task and may poll for a bounded time; synchronous mode calls getToken exactly once. This is a paid CapSolver operation.

Input Parameters

string
Caller-controlled proxy in a CapSolver-supported format. Required only for proxy variants and never returned.
string
CapSolver application identifier for usage attribution.
string
Secret recaptchaDataSValue captured from the target page, when present.
array
Target cookies for supported sites. Values are sent upstream and never returned.
string ("proxyless" | "proxy" | "enterprise_proxyless" | "enterprise_proxy")
Task variant. Proxy variants require proxy; enterprise variants may use enterprise_payload.
string
reCAPTCHA API domain used by the target page, when non-default. Common values are http://www.google.com/ and http://www.recaptcha.net/.
boolean
Whether CapSolver should request a session-capable solution.
string
Action value from the target widget’s anchor request, when present.
string
required
reCAPTCHA site key from the target page.
string
required
Full URL of the page containing reCAPTCHA v2.
boolean
Whether the target uses invisible reCAPTCHA v2.
string ("task" | "synchronous")
How CapSolver should solve the challenge: task creates exactly one asynchronous task and may poll it; synchronous calls getToken exactly once and returns only a ready result.
boolean
Task mode only: wait for a ready result; false returns the task ID immediately. Ignored in synchronous mode.
object
Secret enterprise payload required by some enterprise integrations.
integer
Task mode only: window for scheduling polls. A final scheduled request may use its network timeout; then processing and the task ID are returned. Ignored in synchronous mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SOLVE_RECAPTCHA_V3Solve a standard, enterprise, or M1 reCAPTCHA v3 challenge in task or synchronous mode. Task mode creates exactly one task and may poll for a bounded time. Synchronous mode calls getToken exactly once and rejects M1. M1 variants are high-cost and require provider and site-specific enablement.

Input Parameters

string
Caller-controlled proxy in a CapSolver-supported format. Required only for proxy variants and never returned.
string
CapSolver application identifier for usage attribution.
string ("proxyless" | "proxy" | "enterprise_proxyless" | "enterprise_proxy" | "m1_proxyless" | "m1_proxy" | "enterprise_m1_proxyless" | "enterprise_m1_proxy")
reCAPTCHA v3 task variant. Variants ending in _proxy require proxy. M1 variants are high-cost and require provider and site-specific enablement; use them only when that enablement is confirmed.
string
reCAPTCHA API domain used by the target page, when non-default. Common values are http://www.google.com/ and http://www.recaptcha.net/.
boolean
Whether CapSolver should request a session-capable solution.
string
Action value whose reCAPTCHA v3 score token is requested.
string
required
reCAPTCHA site key from the target page.
string
required
Full URL of the page containing reCAPTCHA v3.
string ("task" | "synchronous")
How CapSolver should solve the challenge: task creates exactly one asynchronous task and may poll it; synchronous calls getToken exactly once and returns only a ready result. Synchronous mode does not support M1 variants.
boolean
Task mode only: wait for a ready result; false returns the task ID immediately. Ignored in synchronous mode.
object
Secret enterprise payload required by some target integrations. Accepted only by enterprise variants and never returned.
integer
Task mode only: window for scheduling polls. A final scheduled request may use its network timeout; then processing and the task ID are returned. Ignored in synchronous mode.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CAPSOLVER_SUBMIT_TASK_FEEDBACKReport whether a previously returned CapSolver token worked, using only the documented minimal task and result fields.

Input Parameters

boolean
required
Whether the returned token successfully solved the target challenge.
string
Optional task identifier from the original result.
string
required
Exact CapSolver task type originally submitted, such as ReCaptchaV2TaskProxyLess.
string
Optional website key from the original task when that family used one.
string
required
Website URL from the original task; no other original task fields are accepted or returned.
integer
Provider errorId from the original result; defaults to zero for a successful result.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not