> 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 190 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** | 190+ countries, with city and ISP level targeting |
| **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, and its remaining data stays available until that billing period ends.
#### 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 190+ countries, or **Random Country** |
| **City** | A specific city in that country, or **Random City** |
| **ISP** | A specific ISP, or **Random Network** |
| **Stickiness** | **Randomize IP** or **Sticky IP** |
| **Hostname** | **DNS Hostname** or **IP Hostname** |
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, so how long one lasts is not 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
