ScrapeUnblocker Documentation

Before you start

You need an API key. Grab one from the pricing page - a free trial is available, no credit card required. The base URL for every request is:

https://api.scrapeunblocker.com

Authenticate by passing your key in the x-scrapeunblocker-key header.

Your first request

Fetch the rendered HTML of any URL:

curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://example.com" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

import requests

r = requests.post(
    "https://api.scrapeunblocker.com/getPageSource",
    params={"url": "https://example.com"},
    headers={"x-scrapeunblocker-key": "YOUR_API_KEY"},
)
print(r.text)

const res = await fetch(
  "https://api.scrapeunblocker.com/getPageSource?url=https://example.com",
  {
    method: "POST",
    headers: { "x-scrapeunblocker-key": "YOUR_API_KEY" },
  }
);
console.log(await res.text());

The response body is the prettified HTML of the target page.

Want structured data instead of HTML?

Add parsed_data=true and the API returns extracted JSON instead - product fields, article content, listing data, whichever fits the page type. Extraction uses Schema.org, __NEXT_DATA__, or AI-generated rules under the hood.

curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://www.amazon.com/dp/B08N5WRWNW&parsed_data=true" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

import requests

r = requests.post(
    "https://api.scrapeunblocker.com/getPageSource",
    params={
        "url": "https://www.amazon.com/dp/B08N5WRWNW",
        "parsed_data": True,
    },
    headers={"x-scrapeunblocker-key": "YOUR_API_KEY"},
)
print(r.json())

Response shape:

{
  "data": {
    "page_type": "product",
    "source": "schema_org",
    "data": {
      "title": "...",
      "price": "...",
      "currency": "USD"
    }
  }
}

See the parsed data guide for the full list of page types and extraction sources.

Scrape a Google SERP

curl -X POST "https://api.scrapeunblocker.com/serpApi?keyword=best+running+shoes&pages_to_check=2" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Returns topAds, bottomAds, organic, totalResults, and the proxy country used. Up to 10 pages per call. Details in the SERP guide.

Fetch an image through a browser

For hosts that block plain image GETs (or serve a tracking pixel to non-browsers):

curl -X POST "https://api.scrapeunblocker.com/getImage?url=https://example.com/photo.jpg" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY" \
  --output photo.png

Returns raw PNG bytes. See the image fetching guide.

What’s next

Authentication

Where to find your key, how to rotate it, security best practices.

Country targeting

Force requests through a specific country’s proxy pool.

Handling failures

What 403, 503, and 504 mean - and how to retry.

Full API Reference

Every parameter for every endpoint.

Get Started

No-code area

Spider Cloud

Plugins

AI Assistants

Guides

Code Examples

Quickstart

Before you start

Your first request

Want structured data instead of HTML?

Scrape a Google SERP

Fetch an image through a browser

What’s next

Authentication

Country targeting

Handling failures

Full API Reference

​Before you start

​Your first request

​Want structured data instead of HTML?

​Scrape a Google SERP

​Fetch an image through a browser

​What’s next

Authentication

Country targeting

Handling failures

Full API Reference

Before you start

Your first request

Want structured data instead of HTML?

Scrape a Google SERP

Fetch an image through a browser

What’s next