Base URL
Authentication
All endpoints require thex-scrapeunblocker-key header. See Authentication for details.
Endpoints
The public API has three endpoints. All other paths onapi.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:
/getPageSourcereturnstext/htmlby default, orapplication/jsonwhenparsed_data=trueorget_cookies=true./serpApialways returnsapplication/json./getImagereturns the image’s own type (image/jpeg,image/webp,image/png,image/gif,image/svg+xml, …), bytes unchanged.
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.

