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. Add a product instance: Click + Add product instance and select your proxy solution (Residential, Mobile, Datacenter, or ISP proxies)

3. Set up your proxies: Choose the proxy type, instance name, (if IP-based type was chosen, set up your IPs), authentication settings, and create the the instance.

4. Get credentials: Click on your proxy product in the overview instance table and confirm your proxy user credentials.

To try our proxies for free, claim a $5 welcome credit.

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.).

• To change protocols:

  • HTTP / HTTPS / SOCKS5: Change the connection prefix in your client (http://, https://, or socks5h://) following with standard endpoints.

  • HTTP/3 & UDP: Route requests via MASQUE at masque.oxylabs.io:50000 (Residential proxies only).

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.

• HTTP/3 & Native UDP (MASQUE): If your target endpoints require native HTTP/3 or QUIC connections, refer to the MASQUE Integration Guide for more setup details details.