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

{% stepper %}
{% step %}

### Setup & credentials

1. **Create an account:** Sign up at the [Oxylabs Dashboard](https://dashboard.oxylabs.io/).
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)

{% hint style="info" %}
If you want a free trial to test our proxies, email our support team at <support@oxylabs.io>.
{% endhint %}
{% endstep %}

{% step %}

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

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

{% endstep %}

{% step %}

### Proxy details

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

<table><thead><tr><th width="172">Proxy type</th><th width="150">Endpoint</th><th width="115">Rotating port</th><th width="125">Username prefix</th><th width="127">Static port</th></tr></thead><tbody><tr><td>Residential</td><td><code>pr.oxylabs.io</code></td><td><code>7777</code></td><td><code>customer-</code></td><td>(use <code>sessid-</code>)</td></tr><tr><td>Mobile</td><td><code>pr.oxylabs.io</code></td><td><code>7777</code></td><td><code>customer-</code></td><td>(use <code>sessid-</code>)</td></tr><tr><td>Datacenter</td><td><code>dc.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> and up</td></tr><tr><td>Dedicated Datacenter</td><td><code>ddc.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> and up</td></tr><tr><td>ISP</td><td><code>isp.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> and up</td></tr><tr><td>Dedicated ISP</td><td><code>disp.oxylabs.io</code></td><td><code>8000</code></td><td><code>user-</code></td><td><code>8001</code> and up</td></tr></tbody></table>

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}

{% step %}

### 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.).
    {% endstep %}
    {% endstepper %}

### 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](/products/proxies.md) section.
* **Using third-party tools?** Find step-by-step guides for Selenium, Playwright, private browsers, proxy managers, and many more in the [Integrations](/integrations/proxy-integrations.md) section.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/get-started/quick-start-proxies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.