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.
The simplest way to test ScrapeUnblocker. Drop these into a terminal, replace YOUR_API_KEY, and you’re scraping.
Fetch page HTML
curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://example.com" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
Fetch page HTML through a specific country
curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://example.com&proxy_country=de" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
Get parsed JSON instead of HTML
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"
Get HTML + cookies + the proxy address used
curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://example.com&get_cookies=true" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
Scrape a Google SERP
curl -X POST "https://api.scrapeunblocker.com/serpApi?keyword=best+running+shoes" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
Scrape multiple SERP pages from a specific country
curl -X POST "https://api.scrapeunblocker.com/serpApi?keyword=pizza&pages_to_check=3&proxy_country=it" \
-H "x-scrapeunblocker-key: YOUR_API_KEY"
Fetch a single image as PNG
curl -X POST "https://api.scrapeunblocker.com/getImage?url=https://example.com/photo.jpg" \
-H "x-scrapeunblocker-key: YOUR_API_KEY" \
--output photo.png
Bash one-liner with API key from environment
export SCRAPEUNBLOCKER_KEY="su_live_..."
curl -X POST "https://api.scrapeunblocker.com/getPageSource?url=https://example.com" \
-H "x-scrapeunblocker-key: $SCRAPEUNBLOCKER_KEY"
URL-encoding parameter values
cURL does not URL-encode for you. If your url parameter contains special characters (&, ?, =, spaces), encode them or wrap them with --data-urlencode:
curl -X POST "https://api.scrapeunblocker.com/getPageSource" \
-H "x-scrapeunblocker-key: $SCRAPEUNBLOCKER_KEY" \
--data-urlencode "url=https://example.com/path?foo=bar&baz=qux" \
-G
-G tells cURL to convert --data-urlencode into query-string parameters while still using POST.