Quick Start: Web Unblocker

Oxylabs Web Unblocker is an AI-powered proxy solution designed to handle the most sophisticated anti-bot systems (e.g., Akamai, Cloudflare, or DataDome). It automatically manages proxy rotation, browser fingerprinting, and CAPTCHA solving so you can focus on the data.

1

Setup & credentials

1. Create an account: Sign up at the Oxylabs Dashboard.

2. Create an API User: Navigate to Web Unblocker → Users and create a username and password (These are credentials to authorize access to Web Unblocker and separate from you dashboard login)

2

Your first request

Web Unblocker is integrated as a proxy. Use the endpoint unblock.oxylabs.io:60000 and pass your instructions via custom headers.

curl -k -x unblock.oxylabs.io:60000 -U 'USERNAME:PASSWORD' \
'https://sandbox.oxylabs.io/products' \
-H 'x-oxylabs-geo-location: United States' \
-H 'x-oxylabs-render: html'

Replace USERNAME and PASSWORD with your User credentials

Essential Headers

Unlike standard proxies, Web Unblocker uses headers to control its AI-driven features:

Header	Value	Description
x-oxylabs-geo-location	United States, Germany, etc.	Sets the exit node to a specific country.
x-oxylabs-render	html or png	Enables JavaScript rendering or returns a screenshot.
x-oxylabs-session-id	AnyRandomString	Keeps the same IP for multiple requests (Sticky Session).
x-oxylabs-force-headers	1	Forces the unblocker to send your own custom headers to the target.

Common response codes

Code	Status	Description
200	OK	Successful request. You receive the full rendered HTML.
401	Unauthorized	Invalid API User credentials or missing authentication.
429	Too Many Requests	You have reached your account's rate limit.
550	Faulted	The system failed to unblock the site after multiple retries.

You can find the full list of response codes in the Web Unblocker product section.

Next Steps

• Advanced browser control: Need to click buttons or scroll? Check out the Custom Browser Instructions in the Products section.

• Geo-targeting: For localized data, see the Geo-location page for targeting specific countries, cities, or coordinates.