Skip to main content

​
Base URL

​
Authentication

All endpoints require the x-scrapeunblocker-key header. See Authentication for details.

​
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, Google’s AI Overview with the pages it cites, total result count, and the proxy country actually used. Supports 1-10 page pagination.

POST /getImage

Download an image exactly as the image host serves it (original format and Content-Type), through rotating proxies and past bot challenges.

​
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 returns the image’s own type (image/jpeg, image/webp, image/png, image/gif, image/svg+xml, …), bytes unchanged.
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.