Back to blog

Migrating to Oxylabs Web Unblocker from Bright Data

vytenis kaubre avatar

Vytenis Kaubrė

2025-06-06

1 min read

If you're using Bright Data's Web Unlocker and considering Oxylabs Web Unblocker as an alternative, this guide covers the key differences and migration steps. We'll compare features, show code examples for both platforms, and outline the specific configuration changes needed to switch your implementation to Oxylabs.

Feature comparison

Oxylabs Web Unblocker provides a comprehensive feature set that mostly matches Bright Data's Web Unlocker, plus some exclusive capabilities that set it apart. Here's a quick comparison of the key differences between these two services:

Feature Bright Data Web Unlocker Oxylabs Web Unblocker
Proxy Endpoint brd.superproxy.io:33335 unblock.oxylabs.io:60000
API Endpoint https://api.brightdata.com/wsapi Not supported yet.
Use Web Scraper API for
API functionality.
Proxy Rotation Automatic Automatic
Captcha Bypass Supported Supported (AI-based)
Pricing Separate pricing
for premium domains
Single price
Geolocation Targeting Supported Supported
Mobile Targeting Supported Not supported
Custom Headers/Cookies Supported Supported
JavaScript Rendering Automatic Manual (more control)
Rendering Possibilities HTML HTML and PNG
Browser Instructions Not supported Supported
POST Requests Not supported Supported
Sessions Not supported Supported
Custom Status Code Not supported Supported

Migration checklist

Update these configuration settings to use Web Unblocker:

  1. Endpoint: Switch your proxy endpoint to unblock.oxylabs.io:60000 (replacing brd.superproxy.io:33335).

  2. Credentials: Update authentication credentials to your Oxylabs Web Unblocker username and password.

  3. Location settings: Use the X-Oxylabs-Geo-Location HTTP header instead of zone-based targeting for geolocation targeting.

  4. SSL verification: Include verify=False in your requests to bypass SSL certificate checks.

  5. Added features: Implement Oxylabs’ unique functionality, like browser instructions, sessions, and POST requests.

Code examples comparison

Where we differ from Bright Data is how geographic targeting works. Bright Data uses zone-specific accounts, whereas Oxylabs enables access to proxies from any location right away by specifying the location setting directly in headers. Consider the following basic code examples of both services.

Bright Data example

import pprint
import requests

username = 'brd-customer-<customer_id>-zone-<zone_name>-country-us'
password = '<zone_password>'
proxy_url = f'http://{username}:{password}@brd.superproxy.io:33335'

proxies = {
    'http': proxy_url,
    'https': proxy_url
}

headers = {}
url = "http://lumtest.com/myip.json"

response = requests.get(url, proxies=proxies, headers=headers)
pprint.pprint(response.json())

Oxylabs example

import requests

# Use your Oxylabs Web Unblocker credentials here
USERNAME, PASSWORD = 'YOUR_USERNAME', 'YOUR_PASSWORD'

# Define a proxy dict with the Oxylabs endpoint
proxies = {
  'http': f'http://{USERNAME}:{PASSWORD}@unblock.oxylabs.io:60000',
  'https': f'https://{USERNAME}:{PASSWORD}@unblock.oxylabs.io:60000',
}

# Specify geolocation and other parameters here
headers = {
    'x-oxylabs-geo-location': 'United States'
}

response = requests.get(
    'https://ip.oxylabs.io/location',
    verify=False,  # Ignore SSL verification
    proxies=proxies,
    headers=headers
)

print(response.json())

Request parameters reference

Here are the essential parameters of Web Unblocker you can send as headers:

Parameter Description Value example
X-Oxylabs-Geo-Location Specifies the geographic location for the request United States, Germany, etc.
X-Oxylabs-Session-Id Creates or continues a session with the specified ID 123randomString
X-Oxylabs-Render Enables JavaScript rendering and returns HTML or PNG html or png
X-Oxylabs-Browser-Instructions Custom browser instructions, like clicking, scrolling, and more JSON with instructions

Wrap up

Transitioning to Oxylabs Web Unblocker takes only a few configuration changes. Beyond matching Bright Data's features, Oxylabs adds browser instructions, session management, POST requests, and more while simplifying pricing and geolocation targeting. Check the Web Unblocker documentation to find more information and code examples for your projects.

About the author

vytenis kaubre avatar

Vytenis Kaubrė

Technical Content Researcher

Vytenis Kaubrė is a Technical Content Researcher at Oxylabs. Creative writing and a growing interest in technology fuel his daily work, where he researches and crafts technical content, all the while honing his skills in Python. Off duty, you may catch him working on personal projects, learning all things cybersecurity, or relaxing with a book.

All information on Oxylabs Blog is provided on an "as is" basis and for informational purposes only. We make no representation and disclaim all liability with respect to your use of any information contained on Oxylabs Blog or any third-party websites that may be linked therein. Before engaging in scraping activities of any kind you should consult your legal advisors and carefully read the particular website's terms of service or receive a scraping license.

Related content

How to Overcome Anti-Bot Systems: Insights & Tactics
author avatar

Yelyzaveta Hayrapetyan

2024-04-22

Web Unblocker Quick Start Guide
vytenis kaubre avatar

Vytenis Kaubrė

2023-04-06

Web Unblocker Vs Self-Managed Proxies
Web Unblocker Vs Self-Managed Proxies
Gabija Fatenaite avatar

Gabija Fatenaite

2023-03-14

Try Web Unblocker

Choose Oxylabs' Web Unblocker to unlock real-time web data hassle-free.

Get the latest news from data gathering world

I’m interested

Try Web Unblocker

Choose Oxylabs' Web Unblocker to unlock real-time web data hassle-free.