Scrapeless API
v1
  • latest
  • v1
Dashboard
Dashboard
v1
  • latest
  • v1
  1. Scraping Browser
  • User
    • Get User Info
      GET
  • Scraping Browser
    • CDP API
    • Browser extensions
      • Upload extension
      • Upgrade extension
      • Delete extension
      • Extension info
      • Extension list
    • Browser profiles
      • Profile list
      • Profile info
      • Delete profile
      • Upgrade profile
      • Create profile
    • Connect
      WSS
    • Running sessions
      GET
    • Live URL
      GET
  • Scraping API
    • shopee
      • Actor List
      • Shopee Product
      • Shopee Search
      • Shopee Rcmd
    • br sites
      • Solucoes cnpjreva
      • Solucoes certidaointernet
      • Servicos receita
      • Consopt
    • amazon
      • API Parameters
      • product
      • seller
      • keywords
    • google search
      • API Parameters
      • Google Search：Advanced search parameters(tbs)
      • Google Search
      • Google Images
      • Google Local
      • Google Shopping
      • Google Videos
    • google trends
      • API Parameters
      • AutoComplete
      • Interest Over Time
      • Compared Breakdown By Region
      • Interest By Subregion
      • Related Queries
      • Related Topics
      • Trending Now
    • google flights
      • API Parameters
      • Round trip
      • One way
      • Multi-city
    • google flights chart
      • API Parameters
      • chart
    • google scholar
      • API Parameters(Google Scholar)
      • API Parameters(Google Scholar Author)
      • API Parameters(Google Scholar Cite)
      • API Parameters(Google Scholar Profiles)
      • Google Scholar
      • Google Scholar Author
      • Google Scholar Cite
      • Google Scholar Profiles
    • Scraper Request
      POST
    • Scraper GetResult
      GET
  • Universal Scraping API
    • JS Render Docs
    • JS Render
      POST
    • Web Unlocker
      POST
  • Crawler
    • Scrape
      • Scrape a single URL
      • Scrape multiple URLs
      • Cancel a batch scrape job
      • Get the status of a scrape
      • Get the status of a batch scrape job
      • Get the errors of a batch scrape job
    • Crawl
      • Crawl multiple URLs based on options
      • Cancel a crawl job
      • Get the status of a crawl job
      • Get the errors of a crawl job
  • Public
    • actor status
      GET
    • actor status
      POST
  1. Scraping Browser

CDP API

Overview#

Scrapeless Scraping Browser extends the standard CDP (Chrome DevTools Protocol) functionality with a series of powerful custom functions to enhance browser automation capabilities. This documentation primarily covers CDP functions related to CAPTCHA handling.

Captcha Solver Features#

Feature Overview#

Scraping Browser includes advanced CAPTCHA solution capabilities that can automatically handle mainstream CAPTCHA types appearing on web pages.

Supported CAPTCHA Types#

reCaptcha
Cloudflare Turnstile

Event Monitoring Mechanism#

Core Events#

Scraping Browser provides three core events to monitor the CAPTCHA solving process:
Event NameDescription
Captcha.detectedCAPTCHA detected
Captcha.solveFinishedCAPTCHA solved
Captcha.solveFailedCAPTCHA solve failed
Event Response Data Structure
FieldTypeDescription
typestringCAPTCHA type: recaptcha turnstile
successbooleanSolution result
messagestringStatus message: "NOT_DETECTED" "SOLVE_FINISHED" "SOLVE_FAILED" "INVALID"
token?stringToken returned on success (optional)

Implementation Examples#

Node.js (Puppeteer)
Python (Playwright)

Advanced Configuration API#

Scraping Browser provides a series of advanced APIs for fine-grained control over the CAPTCHA solver's behavior. Here are the supported APIs:
API NameDescription
Captcha.setAutoSolveControl automatic CAPTCHA solving behavior
Captcha.setTokenSet authentication token for CAPTCHA service
Captcha.setConfigConfigure all CAPTCHA solver parameters
Captcha.solveManually trigger CAPTCHA solving process

Detailed API Description#

1. Captcha.setAutoSolve#

Configuration interface to control automatic CAPTCHA solving behavior.
Node.js (Puppeteer)
Python (Playwright)

2. Captcha.setToken#

Set authentication token for CAPTCHA solving service.
Node.js (Puppeteer)
Python (Playwright)

3. Captcha.setConfig#

Configure all parameters for the CAPTCHA solver.
Node.js (Puppeteer)
Python (Playwright)

4. Captcha.solve#

Manually trigger CAPTCHA solving process.
Node.js (Puppeteer)
Python (Playwright)

5. Agent.click#

Simulates a mouse click.
Node.js (Puppeteer)
Python (Playwright)

6. Agent.liveURL#

Get live url of current session page.
Node.js (Puppeteer)
Python (Playwright)
Modified at 2025-05-21 07:04:52
Previous
Get User Info
Next
Upload extension
Built with