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.

​
Base URL

https://api.scrapeunblocker.com

​
Authentication

All endpoints require the x-scrapeunblocker-key header. See Authentication for details. 
-H "x-scrapeunblocker-key: YOUR_API_KEY"

​
Endpoints

The public API has three endpoints. All other paths on api.scrapeunblocker.com are internal and may change without notice.

POST /getPageSource

Return the rendered HTML for any URL, or extracted structured JSON when parsed_data=true. Supports country targeting, cookie retrieval, custom wait times, and per-domain bypass routing.

POST /serpApi

Scrape Google search results. Returns organic results, top ads, bottom ads, total result count, and the proxy country actually used. Supports 1-10 page pagination.

POST /getImage

Fetch a single image as PNG bytes via a real browser context. For hosts that return challenge pages or tracking pixels to non-browsers.

​
Response format

200 responses are content-type aware:
  • /getPageSource returns text/html by default, or application/json when parsed_data=true or get_cookies=true.
  • /serpApi always returns application/json.
  • /getImage always returns image/png.
Error responses (4xx, 5xx) are application/json with a detail field describing the issue. See Errors for the full list.

​
Conventions

  • Method: all three endpoints use POST. Parameters go in the query string, not the request body.
  • Encoding: URL-encode parameter values. Special characters in url (especially & and ?) must be percent-encoded.
  • Timeouts: set a generous client-side timeout - 120 seconds is a safe baseline. Browser-based bypasses can take 30-60s for cold targets.