# Proxy2Web

**Proxy2Web** is an IP-based proxy solution that operates through a 9Proxy-managed endpoint.\
It allows you to access websites directly from the 9Proxy Dashboard without installing software, configuring local proxies, or setting up authentication.

## How Proxy2Web Works

When you create a Proxy2Web session:

* 9Proxy assigns a residential IP on your behalf
* The proxy runs on our infrastructure, not on your device
* You receive ready-to-use proxy credentials (host, port, username, password)

Your IP balance is affected only after a connection is successfully established.\
If you never connect, nothing is deducted.

## Accessing Proxy2Web

{% embed url="<https://www.youtube.com/watch?v=EY58JRP_fwo>" %}

{% stepper %}
{% step %}
**Log in to the** [**9Proxy Dashboard**](https://9proxy.com/dashboard)
{% endstep %}

{% step %}
**Navigate to** [**Residential Proxies → IPs**](https://9proxy.com/dashboard/residential-proxy-ip)

<figure><img src="/files/0FmuCRM38Lf0sQBxkQOU" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Select Proxy2Web**
{% endstep %}

{% step %}
**Click Create Proxy**
{% endstep %}
{% endstepper %}

From here, you’ll configure how the proxy behaves.

## Getting Started

### 1. Choose a Sub-User

Proxy Web requires selecting a Sub-User to manage access, IP allocation, and usage tracking. Think of a Sub-User as a “profile” that defines how this proxy session can be used.

If you don’t have a Sub-User yet (or want to create a new one):

{% stepper %}
{% step %}
**Click Add New**

<figure><img src="/files/GVq1VYyfNjGjCDnUvHT5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Enter a Username and Password**

<figure><img src="/files/3KgdaXRRGvoZhwRXNoxp" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**In Usage Settings, choose:**

A specific IP/GB limit, or Unlimited, if you want this Sub-User to use your main account’s resources without restriction
{% endstep %}

{% step %}
**(Optional) Add a Remark for easy identification**
{% endstep %}

{% step %}
**Save the Sub-User**
{% endstep %}
{% endstepper %}

If you already have Sub-Users, select one from the Sub-User dropdown

<figure><img src="/files/tl5MYuNJFj6B579Ks4ob" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Note:** You can reuse existing Sub-Users created under Residential Proxies by GB.
{% endhint %}

### 2. Select Proxy Location

Next, choose where your proxy IP should come from. You can be as specific as you like:

<table data-header-hidden><thead><tr><th width="172.888916015625"></th><th></th></tr></thead><tbody><tr><td><strong>Country / Region</strong></td><td>Choose a specific country. If you don’t need a specific location, choosing Random lets the system assign an available residential IP automatically.</td></tr><tr><td><strong>State</strong></td><td>Displays available states within the selected country.</td></tr><tr><td><strong>City</strong></td><td>Shows cities available under the chosen state.</td></tr><tr><td><strong>ISP</strong></td><td>Filter proxies by Internet Service Provider.</td></tr></tbody></table>

{% hint style="info" %}
Tip: Keep in mind that the more filters you apply, the fewer IPs may be available.
{% endhint %}

### 3. Configure Duration (Optional)

By default, Proxy2Web is designed to be worry-free.

If you don’t configure anything here, the system will automatically replace a proxy when it goes offline. In most cases, a proxy IP stays active for several hours, and sometimes up to 24 hours, depending on availability.

<figure><img src="/files/yLsMdzEUy0l1uSBEFCYe" alt=""><figcaption></figcaption></figure>

If you choose to set a Duration, you are telling the system exactly how long you want to keep the current proxy before switching to a new one. Once that time ends, the proxy will be replaced automatically - even if it is still online.

If the proxy goes offline before the duration ends, a new one will be assigned immediately. The system does not wait for the timer to finish, so your access continues without interruption.

### 4. Review Proxy Credentials

After creating the session, you’ll see the proxy details on the right side of the screen, including host, port, username, and password.

You can use these details directly in your browser or any supported tool.

At this point, no IP has been deducted yet.

An IP is deducted only when you actually connect successfully.

#### 4.1. Proxy Endpoint Generator

The Proxy Endpoint Generator helps you format proxy credentials in the way your tool or browser expects.

<figure><img src="/files/qUjb1xE8bKTGW1V4DINd" alt=""><figcaption></figcaption></figure>

You can choose from multiple formats, such as:

```javascript
//format

username:password@hostname:port

hostname:port:username:password

username:password:hostname:port

```

If you just want to test quickly, you can copy an example directly from Endpoint Connection Examples.

If you prefer, you can also build your own connection string.

#### 4.2. Usage History (24H List)

The Usage History (24H List) shows all proxy IPs you’ve used within the last 24 hours.

This is especially useful if you want to:

* Reuse a proxy that becomes available again
* Quickly replace a proxy that no longer fits your needs

1. **Re-use an IP**

If a previously used proxy comes back online, you can reuse it without spending a new IP.

Just open the icon ![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAAAYCAYAAAAGXva8AAACtElEQVR4AexUXU8aURA9uxgpooigi1QFRWjAipJWrA+26U+vaR8UGgORkFKUzw1iJGADFLDA9s411F2Bhb60D+1mZ3fu3Jk592POiJLkUP60iPgLz3/QkYduND7D+robweABjo7ecwkGX3Ob0WgcGTPKONXxzszMYGdnH+HwMVyubRgMIiqVMhdRNMDt9rK5t/D7g2zOMApHY5sISkn39g5gs60gl0vj7OwEsVgEl5dfuMTjEW4rFDJYXnZgd/cVRFE/rf4sW5/X68fc3DzS6SRkOY9er8es2rfb7YJAc2xRCwuL2Nz0ah2ejHRBCUySnMjnr3BzU3oSOjykRV1fy3A6N2Bk9z/s8WDRBXU61/nOSqXCg/cUX1nOQRAESNLqWG9dUKvVhlqtwoEpA1Wuy+UhVSNkW1tzc1un00ajUYfVuszHoz66oHRElGQQSFVMAD7fDt+NIAjw+V7CxRZiMDxWbbPZgNlsHoQN/XVBFaWvoUAud4VSqQiH4zmnRyAQYrqT2Qq8kB6z95kqMBn96oK22y2YTPOayEwmxUCKsNslRiM7r+hM5qvGx2Qyo9X6rrGpB7qgtVoVFssiZme13YaAi8Us3x3RRJ2QrsRiseLurqI2a3RdUKKJIAjweF5ogmhANCJukq4WrzcARVFQLo+nmC5oq9Xk/KROs7ExXLVqMNK3tnxYWrKDuKouQJpTiy4oOdJRErjb7WHFsweqYLKrhY6f2h/Rpl7/hmxWe8dqX9InglLbi8ejqFYrrLdKODx8h/39MLa3/YwuAYRCb1izP2a8tOH2toxE4pwfLyUfJxNBKZB6azIZQzT6iRVPFv2+gpWVVV7Bvd4PtrM0IpGPSKUSvxoJxY2TqUAHwXRPspzFxcVnnJ5+YHLC9HNGoQLu7zsDt4n/3wKdmG1Kh38H9CcAAAD//8F052UAAAAGSURBVAMAkzMeusBPG6AAAAAASUVORK5CYII=) next to the user string. A dropdown will show IPs used within the last 24 **hours under that user. Select Re-use IP.**

<figure><img src="/files/NnLSDwJwW23wUt6iMVVw" alt=""><figcaption></figcaption></figure>

2. **Switch IP**

If you want a fresh proxy immediately, choose Switch IP.

This assigns a new IP right away and deducts one IP from your balance.

## Important Notes

<details>

<summary><strong>IP Deduction Rules</strong></summary>

* IPs are not deducted when generating or preparing a session
* An IP is deducted only when the proxy connection is successfully established

</details>

<details>

<summary><strong>Auto Refresh Proxy (Default Enabled)</strong></summary>

Auto Refresh Proxy is enabled by default.

* If the active IP goes offline during use, the system will automatically switch to another available IP
* This ensures uninterrupted access without manual intervention

</details>


---

# 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://docs.9proxy.com/getting-started/residential-proxy-by-ips/proxy2web.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.
