Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.scrapeunblocker.com/llms.txt

Use this file to discover all available pages before exploring further.

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"
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"
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.