> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/proxidize-proxies/residential-pergb.md).
# Residential - perGB
Everything about the Residential Per GB plan: coverage, access points, targeting, your credentials, changing your IP, and generating proxy lists.
**Residential Per GB** is a monthly data package that gives you access to Proxidize's entire pool of residential IPs, in more than 195 countries.
The IPs come from real homes, sourced ethically and with consent through Proxidize's bandwidth sharing app and partner apps, which is what makes them the product to use for anything outside the United States.
Open Residential Per GB
### What you get
| | |
| --------------- | ---------------------------------------------------------------------------------------- |
| **The IPs** | Real residential ISP addresses from homes worldwide |
| **Coverage** | 195+ countries, with city and ISP level targeting, plus state level in the United States |
| **Packages** | 25 GB to 10,000 GB, priced per GB on the **Buy** tab |
| **Your data** | Unused data rolls over |
| **Pool access** | The entire residential pool, with no fixed proxy count |
Each package is its own monthly subscription with its own billing date. To add data, subscribe to another package.
To reduce it, cancel a package you no longer need. Data you have already bought stays in your balance and never expires. If a package is refunded, its data is removed.
#### Watching your balance
The header of every tab shows how much data you have left and how much you have used.
**Set alert** beside it opens **Usage alert**, where you can turn on an email warning and pick the threshold it fires at, so you hear about a low balance before a job stops.
***
### Access points
An access point defines how your tools connect to the pool. Everything you run goes through one, and they all draw from the same data balance.
Every account starts with one called **Default**, and you can add as many as you need. Most people make one per project or per tool, so they can target and rotate them independently.
The **Access Point** dropdown lists yours in two groups.
#### Named
A named access point has its own username and password, generated for you.
Open the dropdown, choose **+ Create Access Point**, stay on the **User / Pass** tab, and give it a name using letters, numbers and underscores. It is ready the moment you press **Create**.
#### IP whitelist
An IP whitelist access point authenticates by your public IP instead, with no credentials at all.
Create it the same way, on the **IP Whitelist** tab, by entering an IP address or using the **Add my IP** shortcut. Each IP you add becomes its own access point, listed by address.
Its **Proxy Details** shows the host, port and whitelisted IP rather than a username and password, and the proxy list is just host and port.
{% hint style="warning" %}
**IP whitelisting authenticates by source IP alone.**
If your public IP changes, whether from a network switch, a VPN, or an ISP reassignment, access stops until you add the new address. On connections whose IP changes often, a named access point is the more reliable choice.
{% endhint %}
#### Deleting one
Hover an access point in the list and press the **×** that appears.
{% hint style="warning" %}
Deleting an access point is permanent, and the name can never be used again on your account. Anything still pointed at it stops working immediately.
{% endhint %}
***
### Setting up an access point
Select an access point, then use the controls along the top to shape it.
| Control | What it does |
| -------------- | --------------------------------------------------------------------------------------- |
| **Type** | HTTP or SOCKS5 |
| **Country** | Any of the 195+ countries, or **Random Country** |
| **State** | A specific U.S. state, or **Random State** |
| **City** | A specific city in that country, or in the U.S. in the chosen state, or **Random City** |
| **ISP** | A specific ISP, or **Random Network** |
| **Stickiness** | **Randomize IP** or **Sticky IP** |
| **Hostname** | **DNS Hostname** or **IP Hostname** |
{% hint style="warning" %}
**State currently only applies when Country is United States.**
Outside the United States it stays greyed out, hovering it shows "State selection is available for the United States", and you choose the city directly
In the United States, City stays greyed out until you choose a state, and then lists only the cities in that state.
Changing the state puts City back to Random City.
{% endhint %}
Changes save to that access point as you make them. There is no save step, and each access point keeps its own settings, so switching between them switches the whole row.
{% hint style="info" %}
**Changing these settings also changes that access point's username.**
If you have already copied its credentials into a tool, copy them again after you make a change, or the old ones will no longer match.
{% endhint %}
Cities and ISPs are listed dynamically for the country you pick, so what you see is what the pool can currently serve there.
#### Targeting and the size of your pool
Per GB reaches the entire pool, and every filter you add narrows the part of it you are drawing from.
***
### Your credentials
**Proxy Details** holds the host, port, username and password for the selected access point, each with a copy button. The button beside the password regenerates it.
**Test with cURL** below it gives you a ready to run command built from your current settings, which returns the IP your request went out on. Run it twice to see stickiness working.
***
### Changing your IP
Per GB has no rotate button and no rotation URL, because you are not holding a fixed proxy. Your IP comes from the pool, and **Stickiness** decides how long you keep it.
* **Randomize IP** gives you a new IP on each request, which suits scraping and high volume automation.
* **Sticky IP** holds one IP for the session, identified by a session key in your username.
In Sticky IP your username carries a session segment, `-s-` followed by a token. Change that token to any other value and you get a different proxy from the pool, which is what makes large lists scriptable.
**Refresh Session IDs**, at the top right of **Proxy Details**, appears only in Sticky IP and replaces every session key at once.
Sticky IPs are held by the residential ISP rather than by us, and typically last about 1 to 3 hours. The exact time isn't something we control.
***
### Generating a proxy list
**Formatted Proxy List** turns the selected access point into a list you can paste into a tool.
Choose how many rows you want, pick the line format, either `hostname:port:username:password` or `username:password@hostname:port`, then copy the list or download it as a file.
The ports selector decides whether every row shares a port or gets its own. **Static** gives them all the same port, and **Dynamic** gives each row its own, counting down from `20000` for HTTP and up from `20002` for SOCKS5. Reach for **Dynamic** when a tool refuses to accept two proxies on the same port.
{% hint style="info" %}
To build one list that mixes different cities, ISPs, access points, or generate a list of a huge number of proxies, use the [perGB - Session Builder](/proxidize-proxies/pergb-session-builder.md).
{% endhint %}
***
### Quick FAQ
What happens to data I do not use?
On Residential Per GB unused data rolls over, so it stays available rather than expiring at the end of the month.
How many proxies do I get?
There is no fixed number. Per GB gives you access to the whole pool, and you draw as many proxies from it as your data allows.
My credentials stopped working. What changed?
Most often the access point's settings were changed after the credentials were copied, which rewrites its username. Copy the current username and password from **Proxy Details** again. If it is an IP whitelist access point, check whether your public IP has changed.
Why do I keep getting the same IPs?
Usually because the access point is filtered tightly. A single country plus a single city plus a single ISP can leave a small pool behind it. Loosen a filter or switch to **Random City** and the repeats stop.
Should I use Residential or Mobile?
Residential for anything outside the United States, and for work that benefits from home ISP addresses. Mobile for U.S. traffic that needs to look like a phone on a mobile network. See [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies.md).
***
### Related articles
* [perGB - Session Builder](/proxidize-proxies/pergb-session-builder.md)
* [Mobile - PerGB](/proxidize-proxies/mobile-proxies/mobile-pergb.md)
* [perProxy vs perGB](/proxidize-proxies/perproxy-vs-pergb.md)
* [Choose Between Mobile and Residential Proxies](/getting-started/choose-between-mobile-and-residential-proxies.md)
* [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies.md)
***
### Need help?
If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at .
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.proxidize.com/proxidize-proxies/residential-pergb.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
