Scraper

Scrape a website using the Web Unlocker

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.

GET
/
x-api-token<token>

In: header

Query Parameters

url*string

Target website URL to scrape

Formaturi
token*string

API authentication token

timeout?integer

Maximum time in seconds to wait for the page to load before returning a response

Default30
geoCode?string

ISO 3166-1 alpha-2 country code to route the request through a proxy in that country, useful for geo-restricted content

browserRendering?boolean

When true, renders the page using a full headless browser (JavaScript execution enabled). Use for SPAs and dynamic content. When false, performs a plain HTTP request.

Defaultfalse
waitForSelector?string

A CSS selector to wait for before returning the page content. The scraper will pause until the matching element appears in the DOM. Only applicable when browserRendering is true.

homePage?boolean

Navigate to the site's home page before visiting the target URL.

Defaultfalse
blockResources?boolean

Block resource loading through the proxy to improve performance if set to TRUE.

maxRetries?integer

The maximum number of retry attempts if the scrape fails.

Default3
tokenCap?integer

The maximum number of tokens that can be consumed across retry attempts. If the first scrape exceeds the token cap, it still runs once but no retries are performed.

Response Body

text/html

application/json

application/json

application/json

application/json

curl -X GET "https://api.app.mrscraper.com/?url=https%3A%2F%2Fwww.amazon.com%2Fstores%2Fluxurystores%2Fpage%2FB6BC6264-7221-424B-9191-DAE2BCF963A2&token=atk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&timeout=120&geoCode=pt&browserRendering=true&waitForSelector=div%5Bdata-testid%3D%22grid-item-info%22%5D&homePage=false&blockResources=true&maxRetries=3&tokenCap=10"
"string"
{
  "message": "Unauthorized access",
  "error": "Unauthorized"
}
{
  "message": "You do not have permission to access this resource",
  "error": "Forbidden",
  "statusCode": 403
}
{
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422
}
{
  "message": "Too many requests. Please try again later."
}