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 engineered for high-performance data scraping and improved web access. While 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)

To try our proxies with a free trial, contact 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 for HTTP or 1.2.3.4:1180 for 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.