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",
    "data": {
      "title": "...",
      "price": "...",
      "currency": "USD"
    }
  }
}

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

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

For image hosts that block plain GETs from your servers:

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

Returns the image bytes in their original format, with the image’s own Content-Type. 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

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

​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

What’s next