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.

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"
"string"
{
  "message": "Invalid or missing API token",
  "error": "Unauthorized",
  "statusCode": 401
}
{
  "message": "You do not have permission to access this resource",
  "error": "Forbidden",
  "statusCode": 403
}
{
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422
}
{
  "message": "An unexpected error occurred",
  "error": "Internal Server Error",
  "statusCode": 500
}