MrScraperMrScraper
Dashboard
DocumentationAPI ReferenceResidential ProxyChangelog

Web Unblocker

Retrieve the raw HTML of any webpage with the Web Unblocker endpoint, supporting browser rendering, geo-targeting, and waiting for DOM selectors.

This endpoint scrapes a target URL with Unblocker feature that supports browser rendering, geo-targeting via proxy, and waiting for specific DOM selectors before extracting content.

Note

  • Use the Playground API Server (https://api.mrscraper.com) host when calling this endpoint.
  • This is the same endpoint as Scrape HTML in Playground.
GET
/

Query Parameters

token*string

API token.

url*string

The full URL of the page you want to scrape. Must include the protocol (https://). You can also paste a cURL command here to auto-apply all settings.

Formaturi
html*boolean
Defaulttrue
super?boolean

Route requests through real devices to bypass anti-bot protection.

browserRendering?boolean

Render page using Chromium.

waitUntil?string

Defines when the browser considers navigation complete. 'Network Idle 0' waits until all network activity stops — most thorough but slowest

Value in"domcontentloaded" | "load" | "networkidle0" | "networkidle2"
timeout?integer

Maximum seconds to wait for the page to fully load before the request times out. Increase for slow or complex pages

blockResources?boolean

Block images, fonts, and stylesheets from loading. Speeds up scraping and reduces bandwidth usage

waitForSelector?string

Pause until a specific CSS selector appears in the DOM. Useful for content that loads asynchronously after the initial page load

returnCookie?boolean

Include the browser session cookies from the scraped page in the API response

geoCode?string

The geographic code for the location of the proxy server

proxyCountry?string

The country of the proxy server

Header Parameters

x-api-token*string

API token.

Response Body

text/html

application/json

application/json

curl -X GET "https://api.mrscraper.com/?token=string&url=http%3A%2F%2Fexample.com&html=true" \  -H "x-api-token: string"
"<!DOCTYPE html><html lang=\"en\"><head><title>Example Domain</title><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"><style>body{background:#eee;width:60vw;margin:15vh auto;font-family:system-ui,sans-serif}h1{font-size:1.5em}div{opacity:0.8}a:link,a:visited{color:#348}</style></head><body><div><h1>Example Domain</h1><p>This domain is for use in documentation examples without needing permission. Avoid use in operations.</p><p><a href=\"https://iana.org/domains/example\">Learn more</a></p></div></body></html>"
{
  "error": "Unauthorized",
  "message": "Invalid or missing API token",
  "statusCode": 401
}
{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred",
  "statusCode": 500
}

Error Handling

Learn how the MrScraper API reports errors, including common error codes, response formats, and best practices for handling them in your app.

Scrape Markdown POST

Convert any web page into clean, LLM-friendly Markdown with the Scrape Markdown endpoint, stripping navigation, scripts, and ads for token-efficient AI input.