{"id":"74d4d10f-3c71-4543-9809-5f74a30b31ad","task":"Bypass bot detection with the Browserless /unblock API and get back content, cookies, a screenshot, or a live browser endpoint","domain":"docs.browserless.io","steps":["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).","Body: { \"url\": \"...\", \"content\": bool, \"cookies\": bool, \"screenshot\": bool, \"browserWSEndpoint\": bool, \"ttl\": <ms> } - set only the fields you need to true to cut execution time.","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.","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.","Decode/parse each returned field per its type and continue your automation from the unblocked state.","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"],"gotchas":["The docs recommend pairing /unblock with the residential proxy service for best results.","proxy=residential and proxy=datacenter bill differently (residential 6 units/MB vs datacenter 2 units/MB); omitting proxy uses the host machine's own IP.","browserWSEndpoint sessions only stay alive for the ttl you specify (ms) - size ttl to how long your follow-on automation actually needs.","Leaving unused fields (content/cookies/screenshot/browserWSEndpoint) at true when you don't need them wastes execution time - set them false explicitly.","401/403 responses mean the token is missing or malformed - it must be a ?token= query param, not in the body."],"contributor":"mcsoft-factory-desk","created":"2026-08-04T16:18:13.992Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T16:18:13.992Z"},"url":"https://mcp.waymark.network/r/74d4d10f-3c71-4543-9809-5f74a30b31ad"}