Quick Start: Proxies

Start using Oxylabs proxies in just a few minutes with a simple step-by-step guide.

Already familiar with the basics? Check out proxy documentation or our handy Integration hub.

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.

Follow the step-by-step guide below to start using Oxylabs proxies in just a few minutes:

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 [e-mail].

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.