Quick Start: Proxies

Oxylabs offers a variety of proxy types to help you with any proxy needs. While the use cases for Residential, Datacenter, and ISP proxies differ, the core integration logic is nearly identical.

1

Setup & credentials

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

2. Purchase a plan: Select your proxy type (Residential, Mobile, Datacenter, Dedicated Datacenter, ISP, or Dedictaed ISP proxies).

3. Create a Proxy User: Navigate to your product in the dashboard and create a Proxy User (These are credentials to access your proxies separate from you dashboard login)

If you want a free trial to test our proxies, email our support team at [email protected].

2

Your first request

The most efficient way to test your connection is with a cURL command. Copy the template below and replace the placeholders with the values from the Proxy details in Step 3.

curl -x ENDPOINT:PORT -U "PREFIX-USERNAME:PASSWORD" https://ip.oxylabs.io/location

3

Proxy details

Find your specific product below to identify the correct connection details:

Proxy type	Endpoint	Rotating port	Username prefix	Static port
Residential	pr.oxylabs.io	7777	customer-	(use sessid-)
Mobile	pr.oxylabs.io	7777	customer-	(use sessid-)
Datacenter	dc.oxylabs.io	8000	user-	8001 and up
Dedicated Datacenter	ddc.oxylabs.io	8000	user-	8001 and up
ISP	isp.oxylabs.io	8000	user-	8001 and up
Dedicated ISP	disp.oxylabs.io	8000	user-	8001 and up

If you purchased Dedicated Datacenter Proxies (Enterprise) through our Sales Team, you may connect via Direct IP (e.g., 1.2.3.4:60000(HTTP) or 1.2.3.4:1180(SOCKS5)) or use the endpoint provided by your Account Manager. Username requires no prefix.

4

Customizing your request

Once you have the basic connection working, you can customize your session or geo-targeting:

• To target a country:

  • Residential/Mobile: Add -cc-US to your username string (adjust the country code accordingly).

  • Shared DC/ISP: Add -country-US to your username string (adjust the country code accordingly).

  • Dedicated (DC/ISP): Use the port assigned to an IP in the target country (consult the Proxy List in your dashboard).

• To keep a static session:

  • Residential / Mobile proxies: Add -sessid-qwerty123 to your username string at the end.

  • All Other Types: Change the Port (e.g., use 8001 for IP #1, 8002 for IP #2, etc.).

Next Steps

Now that you've confirmed your connection, here is where to go further:

• Need advanced features? See the full feature breakdown for each type in the Products section.

• Using third-party tools? Find step-by-step guides for Selenium, Playwright, private browsers, proxy managers, and many more in the Integrations section.