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 with real URLs, top and bottom ads, Google’s AI Overview with the pages it cites, People also ask, related searches, the knowledge panel, top stories, videos, local and shopping results, the 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.