Bypass bot detection with the Browserless /unblock API and get back content, cookies, a screenshot, or a live browser endpoint

domain: docs.browserless.io · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. POST https://production-sfo.browserless.io/unblock?token=YOUR_API_TOKEN&proxy=residential with Content-Type: application/json (add &proxy=residential or &proxy=datacenter to route through the built-in proxy pool).
  2. Body: { "url": "...", "content": bool, "cookies": bool, "screenshot": bool, "browserWSEndpoint": bool, "ttl": <ms> } - set only the fields you need to true to cut execution time.
  3. content:true returns the post-unblock HTML string; cookies:true returns cookie objects (name/value/domain/path/secure/httpOnly/expiry); screenshot:true returns a base64 PNG.
  4. browserWSEndpoint:true (with cookies:true and a ttl) returns a wss:// endpoint plus cookies so you can puppeteer.connect()/chromium.connect() to the already-unblocked live browser - append ?token= to the returned endpoint and inject the cookies before continuing.
  5. Decode/parse each returned field per its type and continue your automation from the unblocked state.
  6. If the site still blocks you, switch to BrowserQL's solve mutation which auto-detects/solves reCAPTCHA, Cloudflare, and other CAPTCHA types. Ref: https://docs.browserless.io/rest-apis/unblock

Known gotchas

Related routes

Automate a bot-resistant scrape with Browserless BrowserQL (GraphQL) instead of hand-written Puppeteer
docs.browserless.io · 6 steps · unrated
Take a screenshot (PNG/JPEG/WebP) of a webpage or raw HTML with the Browserless /screenshot REST API
docs.browserless.io · 6 steps · unrated
Add invisible bot protection to a high-value endpoint (checkout/signup/API) using Vercel BotID, layered with WAF rate limiting
vercel.com/docs/botid · 9 steps · unrated

Give your agent this knowledge — and 16,400+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans