# FlashProxy Documentation

Full documentation corpus for LLM ingestion. Source: https://www.flashproxy.com/docs


---

# Introduction
Source: https://www.flashproxy.com/docs

# FlashProxy Documentation

Everything you need to start sending traffic through FlashProxy — connection details, code examples, and a guide for every product, backed by 99.98% network uptime.

## Start here

- **[Quickstart](/docs/getting-started)** — get connected in three steps.
- **[Authentication](/docs/authentication)** — how credentials work.
- **[Proxy formats](/docs/proxy-formats)** — HTTP and SOCKS5 connection strings.
- **[Rotating & sticky sessions](/docs/sessions)** — control IP rotation.
- **[Geo-targeting](/docs/geo-targeting)** — target by country, state, city, or ASN.

## Products

| Product                                                                                                 | Best for                                 |
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| [Residential](/docs/products/residential)                                                               | Premium scraping with deep geo-targeting |
| [Residential Lite](/docs/products/residential-lite)                                                     | High volume on a budget                  |
| [Unlimited Residential](/docs/products/unlimited-residential)                                           | Max-scale, unmetered bandwidth           |
| [Datacenter](/docs/products/datacenter)                                                                 | Speed-critical tasks                     |
| [ISP (US)](/docs/products/isp) / [ISP (EU)](/docs/products/isp-eu)                                      | Residential trust at datacenter speed    |
| [IPv6 Residential](/docs/products/ipv6-residential) / [IPv6 Datacenter](/docs/products/ipv6-datacenter) | IPv6-first targets                       |
| [Mobile](/docs/products/mobile)                                                                         | Authentic 4G/5G carrier IPs              |
| [Dedicated ISP](/docs/products/dedicated-isp)                                                           | Static, identity-bound IPs               |

Need a hand? [Talk to a proxy expert](/contact).


---

# Quickstart
Source: https://www.flashproxy.com/docs/getting-started

# Quickstart

Get your first proxied request working in three steps.

## 1. Create an account

[Sign up](/auth/register) and open your dashboard.

## 2. Get your credentials

Every plan comes with a proxy **username** and **password** — FlashProxy uses Basic authentication. You'll find them on your plan's page in the dashboard. See [Authentication](/docs/authentication) for details.

## 3. Make a request

Point your client at the gateway for your product. Using Residential as an example:

```bash
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

Prefer code? The same request in Python and Node.js:

```python
import requests

proxy = "http://USERNAME:PASSWORD@adam.flashproxy.io:8080"
print(requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}).text)
```

```javascript
import { ProxyAgent } from 'undici';

const dispatcher = new ProxyAgent(
  'http://USERNAME:PASSWORD@adam.flashproxy.io:8080'
);
console.log(await (await fetch('https://api.ipify.org', { dispatcher })).text());
```

If it prints an IP that isn't yours, you're connected. See [Code examples](/docs/code-examples) for httpx, axios, Scrapy, Playwright, Puppeteer, and Selenium.

> **Getting a `407`?** Your username or password is wrong or stale — re-check it in the dashboard. See [Troubleshooting](/docs/troubleshooting).

## Next steps

- Choose a [session type](/docs/sessions) — rotating or sticky.
- Add [geo-targeting](/docs/geo-targeting) to control where your IPs come from.
- Browse the per-product guides for connection details and pricing.


---

# Authentication
Source: https://www.flashproxy.com/docs/authentication

# Authentication

FlashProxy uses **Basic authentication** at the gateway. Every request carries a proxy **username** and **password** — there are no API tokens or bearer auth.

## Your credentials

Each plan ships with its own `proxy_username` and `proxy_password`. Find them on your plan's page in the [dashboard](/dashboard) — copy them straight into your proxy string:

```bash
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

The same `USERNAME:PASSWORD` pair works for both HTTP and SOCKS5. See [Proxy formats](/docs/proxy-formats) for the full connection-string shapes.

## Regenerating credentials

If your credentials leak or stop working, regenerate them from the plan's page in the dashboard. The old pair stops working immediately, so update every client that uses it.

## `407 Proxy Authentication Required`

A **407** means the credentials you sent are stale or invalid — the gateway rejected the Basic auth. Re-check the username and password against the dashboard, and regenerate them if they don't match. More in [Troubleshooting](/docs/troubleshooting).

## IP allowlist (optional)

You can add an **IP allowlist** as an optional second-factor lock layered on top of `user:pass` — requests are accepted only from approved IPs. It is not a standalone method: `user:pass` is always required.

> **Note:** `user:pass` is the only primary authentication method, and it works the same way across every plan.


---

# Proxy formats
Source: https://www.flashproxy.com/docs/proxy-formats

# Proxy Formats

FlashProxy speaks **HTTP** and **SOCKS5**. Any L7 protocol — **HTTP/1.1, HTTP/2, HTTP/3, and HTTPS** — tunnels over either one, and you're free to use whichever your client speaks. The connection string always embeds your [credentials](/docs/authentication) and points at the [gateway](/docs/index) for your product.

## HTTP

```bash
http://USERNAME:PASSWORD@host:port
```

```bash
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

## SOCKS5

```bash
socks5://USERNAME:PASSWORD@host:port
```

```bash
curl -x "socks5://USERNAME:PASSWORD@dc.flashproxy.io:666" https://api.ipify.org
```

## Ports

| Product               | HTTP port | SOCKS5 port |
| --------------------- | --------- | ----------- |
| Residential, Mobile   | **8080**  | **1080**    |
| Residential Lite      | **6969**  | **6969**    |
| Datacenter            | **777**   | **666**     |
| Shared ISP (US & EU)  | **30**    | **31**      |
| IPv6 Residential      | **30**    | **31**      |
| IPv6 Datacenter       | **50**    | **51**      |
| Unlimited Residential | **10507** | **10507**   |

Each product page lists its exact gateway host and ports.

## SOCKS5 UDP

**SOCKS5 UDP ASSOCIATE is live** on **Datacenter, IPv6 Residential, IPv6 Datacenter, and Shared ISP** — UDP datagrams are relayed through the SOCKS5 UDP ASSOCIATE command. It's a capability of the SOCKS5 method, not a separate protocol.

> **Note:** The two proxy methods are **HTTP** and **SOCKS5**. The application-layer (L7) protocol you run over them — HTTP/1.1, HTTP/2, **HTTP/3**, or HTTPS — is your choice; FlashProxy doesn't restrict it.


---

# Rotating & sticky
Source: https://www.flashproxy.com/docs/sessions

# Rotating & Sticky Sessions

FlashProxy gives you two ways to control the IP behind your requests.

## Rotating

A **fresh IP for every request**. Best for high-volume work — scraping, crawling, price monitoring — where you want maximum IP diversity and don't care which IP serves any single request.

## Sticky

The **same IP persists across multiple requests**. Use it when a workflow has to keep one identity — logins, multi-step flows, cart sessions, account warming. **How long an IP holds depends on the product:**

- **Residential & mobile pools** (Residential, Mobile, Unlimited Residential): the IP sticks **until the device rotates off the pool** — typically **up to ~2 hours**. You don't set an exact lifetime; the pool's device availability governs it.
- **ISP (US & EU), Datacenter, and IPv6** (large shared pools): hold an IP for **as long as you need**, or **pin a specific IP from the pool** with the IP-targeting flag `-ip-0_0_0_0` in your username (see [Geo-targeting](/docs/geo-targeting)).
- **Dedicated ISP**: you **own** the IP — every request exits that same static IP. There's nothing to pin or rotate; persistence is built in.

## Which products support sticky

Most products support **both rotating and sticky**: Residential, Datacenter, Mobile, Shared ISP (US & EU), Dedicated ISP, IPv6 Residential, IPv6 Datacenter, and Unlimited Residential.

**Exception:** **Residential Lite is rotating-only** — it does not offer sticky sessions.

## When to use each

| Goal                                                 | Session type  |
| ---------------------------------------------------- | ------------- |
| Maximum IP diversity, high request volume            | Rotating      |
| Keep one identity across a multi-step flow           | Sticky        |
| Price-sensitive, high-volume jobs (Residential Lite) | Rotating only |

> **Note:** Choosing a session type is done through your connection settings — see the per-product guides and [Geo-targeting](/docs/geo-targeting) for how options combine in the username.


---

# Geo-targeting
Source: https://www.flashproxy.com/docs/geo-targeting

# Geo-Targeting

FlashProxy lets you control where your IPs come from. The depth available depends on the product.

## Targeting depth by product

| Product                                | Targeting                                        |
| -------------------------------------- | ------------------------------------------------ |
| **Residential**                        | country → state → city → **ASN** (deepest)       |
| **Mobile**                             | country, **carrier ASN**, session                |
| **Residential Lite**                   | country only                                     |
| **Unlimited Residential**              | country only                                     |
| **Datacenter**                         | country (US-only)                                |
| **Shared ISP (US / EU)**               | country                                          |
| **IPv6 Residential / IPv6 Datacenter** | country (US-only)                                |
| **Dedicated ISP**                      | you own specific static IPs (US, DE, CA, UK, AU) |

- **Residential** is the deepest: target down to city and ASN.
- **ASN / carrier targeting** is available on **Mobile** (carrier) and **Residential**.
- **Residential Lite** and **Unlimited Residential** are **country-level only**.

## How to add targeting

Targeting parameters are encoded into your proxy **username**, alongside your session choice. Build the username in the [dashboard](/dashboard) generator for your plan, then drop it into the connection string from [Proxy formats](/docs/proxy-formats).

For the exact username encoding — parameter names, ordering, and accepted values — see the [API reference](https://rapi.flashproxy.com/docs).

## Pinning a specific IP

On **ISP, Datacenter, and IPv6** plans — the large shared pools with many IPs — you can target one exact IP instead of letting the pool choose, by adding the IP-targeting flag to your username:

```text
-ip-0_0_0_0
```

Replace `0_0_0_0` with the IP you want (dots written as underscores). This keeps the **same IP for as long as you need** — see [Rotating & sticky sessions](/docs/sessions) for how IP persistence differs across products.

> **Dedicated ISP is different:** you **own** the IP(s) on the plan, so all your traffic already exits your assigned static IP — there's nothing to pin or rotate. The `-ip-` flag is only for the shared pools above.

> **Note:** A product can only target as deep as the table above allows — asking for a city on a country-only plan won't apply. See [Troubleshooting](/docs/troubleshooting) if geo-targeting doesn't take effect.


---

# Code examples
Source: https://www.flashproxy.com/docs/code-examples

# Code examples

Connect to FlashProxy from any language or framework. Every product uses the **same** connection pattern — your **username** and **password** with your product's **host** and **port**:

```text
USERNAME:PASSWORD@HOST:PORT
```

The examples below use the **Residential** gateway (`adam.flashproxy.io:8080`). Swap in your product's host and port from its page in [Products](/docs), and replace `USERNAME` / `PASSWORD` with your plan's proxy credentials. Each example fetches your exit IP from `api.ipify.org` — if it prints an IP that isn't yours, you're connected.

> **Where do `USERNAME` / `PASSWORD` come from?** They're your **plan's** `proxy_username` and `proxy_password` — generated per plan and shown on that plan's page in the [dashboard](/dashboard). They are _not_ your FlashProxy account login. See [Authentication](/docs/authentication) for the full details.

> For **SOCKS5**, use `socks5://` and the SOCKS port instead (see [Proxy formats](/docs/proxy-formats)). For **sticky sessions** and **geo-targeting**, build the username in the dashboard generator (see [Rotating & sticky](/docs/sessions) and [Geo-targeting](/docs/geo-targeting)).

## cURL

```bash
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

## Python — requests

```python
import requests

proxy = "http://USERNAME:PASSWORD@adam.flashproxy.io:8080"
proxies = {"http": proxy, "https": proxy}

resp = requests.get("https://api.ipify.org", proxies=proxies)
print(resp.text)
```

Install with `pip install requests`.

## Python — httpx (async)

```python
import asyncio
import httpx

proxy = "http://USERNAME:PASSWORD@adam.flashproxy.io:8080"

async def main():
    async with httpx.AsyncClient(proxy=proxy) as client:
        resp = await client.get("https://api.ipify.org")
        print(resp.text)

asyncio.run(main())
```

Install with `pip install httpx`. Requires httpx **0.26+** (the `proxy=` argument); older versions use `proxies={"http://": proxy, "https://": proxy}` instead.

## Node.js — axios

```javascript
import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
  'http://USERNAME:PASSWORD@adam.flashproxy.io:8080'
);

const resp = await axios.get('https://api.ipify.org', {
  httpAgent: agent,
  httpsAgent: agent,
});
console.log(resp.data);
```

Install with `npm install axios https-proxy-agent`.

## Node.js — fetch (undici)

```javascript
import { ProxyAgent } from 'undici';

const dispatcher = new ProxyAgent(
  'http://USERNAME:PASSWORD@adam.flashproxy.io:8080'
);

const resp = await fetch('https://api.ipify.org', { dispatcher });
console.log(await resp.text());
```

Node 18+ ships a global `fetch`; install the agent with `npm install undici`.

## Scrapy

Set the proxy on every request with a small downloader middleware:

```python
# middlewares.py
class FlashProxyMiddleware:
    PROXY = "http://USERNAME:PASSWORD@adam.flashproxy.io:8080"

    def process_request(self, request, spider):
        request.meta["proxy"] = self.PROXY
```

```python
# settings.py
DOWNLOADER_MIDDLEWARES = {
    "myproject.middlewares.FlashProxyMiddleware": 610,
}
```

## Playwright (Python)

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(
        proxy={
            "server": "http://adam.flashproxy.io:8080",
            "username": "USERNAME",
            "password": "PASSWORD",
        }
    )
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print(page.inner_text("body"))
    browser.close()
```

## Puppeteer (Node.js)

```javascript
import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://adam.flashproxy.io:8080'],
});
const page = await browser.newPage();
await page.authenticate({ username: 'USERNAME', password: 'PASSWORD' });
await page.goto('https://api.ipify.org');
console.log(await page.evaluate(() => document.body.innerText));
await browser.close();
```

## Selenium (Python)

Selenium can't pass proxy credentials directly — use **selenium-wire**:

```python
from seleniumwire import webdriver

proxy = "http://USERNAME:PASSWORD@adam.flashproxy.io:8080"
options = {"proxy": {"http": proxy, "https": proxy, "no_proxy": "localhost,127.0.0.1"}}

driver = webdriver.Chrome(seleniumwire_options=options)
driver.get("https://api.ipify.org")
print(driver.find_element("tag name", "body").text)
driver.quit()
```

Install with `pip install selenium-wire`.

## Browser (manual)

Enter the host and port in your browser's network/proxy settings; it will prompt for the username and password on first connect. For per-profile control, use an extension like FoxyProxy and add `adam.flashproxy.io:8080` with your credentials.


---

# Residential
Source: https://www.flashproxy.com/docs/products/residential

# Residential Proxies

Premium rotating residential IPs sourced through ISP partnerships — the best choice when IP quality and precise geo-targeting matter.

## Specs

- **Pool:** 100M+ IPs, millions active daily
- **Typical response time:** ~400 ms
- **Protocols:** HTTP, SOCKS5
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 50,000 concurrent connections
- **Best for:** web scraping, data collection, anything needing deep geo-targeting

## Connect

**Gateway:** `adam.flashproxy.io` — port **8080** (HTTP) / **1080** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@adam.flashproxy.io:1080" https://api.ipify.org
```

## Request parameters

Targeting and session options are encoded **into the username**, each appended as a `-key-value` pair after your base username:

```text
USERNAME-country-US-state-california-session-a1b2c3d4-time-long
```

Residential supports the deepest targeting in the catalogue:

| Parameter      | Format                            | Example                      | Notes                               |
| -------------- | --------------------------------- | ---------------------------- | ----------------------------------- |
| Country        | `country-<ISO2>`                  | `country-US`                 | Comma-join several: `country-US,GB` |
| State          | `state-<name>`                    | `state-california`           | Lower-case, no spaces               |
| City           | `city-<name>`                     | `city-newyork`               | Lower-case, no spaces               |
| ASN            | `asn-<number>`                    | `asn-7922`                   | Target a specific network           |
| Sticky session | `session-<id>-time-<long\|short>` | `session-a1b2c3d4-time-long` | Omit entirely for a rotating IP     |

For the complete reference — parameter ordering and every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — United States
curl -x "http://USERNAME-country-US:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# Sticky — hold the same US IP across the session
curl -x "http://USERNAME-country-US-session-a1b2c3d4-time-long:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# City-level — New York, NY
curl -x "http://USERNAME-country-US-state-newyork-city-newyork:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# Specific ASN
curl -x "http://USERNAME-country-US-asn-7922:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

## Sessions

Use **rotating** for high-volume scraping (maximum IP diversity) or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale. See [Residential pricing](/pricing/residential).

## Quickstart

1. Buy a Residential plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above, adding targeting parameters as needed.


---

# Residential Lite
Source: https://www.flashproxy.com/docs/products/residential-lite

# Residential Lite Proxies

Budget-friendly residential coverage at the lowest entry price in the catalogue — built for high-volume jobs where cost-per-GB is the primary lever.

## Specs

- **Coverage:** 201+ countries (country-level targeting)
- **Typical response time:** ~421 ms
- **Success rate:** 99.5%
- **Protocols:** HTTP, SOCKS5
- **Sessions:** rotating only (no sticky)
- **Concurrency:** up to 50,000 concurrent connections
- **Best for:** high-volume scraping and price-sensitive operations

## Connect

**Gateway:** `lite.flashproxy.io` — port **6969** (HTTP) / **6969** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@lite.flashproxy.io:6969" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@lite.flashproxy.io:6969" https://api.ipify.org
```

## Request parameters

Targeting is encoded **into the username**, appended as a `-key-value` pair after your base username. Residential Lite is **country-level only** and **rotating-only** (no sticky sessions):

| Parameter | Format           | Example      | Notes                               |
| --------- | ---------------- | ------------ | ----------------------------------- |
| Country   | `country-<ISO2>` | `country-US` | Comma-join several: `country-US,GB` |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — any country
curl -x "http://USERNAME:PASSWORD@lite.flashproxy.io:6969" https://api.ipify.org
```

```bash
# Rotating — United Kingdom
curl -x "http://USERNAME-country-GB:PASSWORD@lite.flashproxy.io:6969" https://api.ipify.org
```

## Sessions

Residential Lite is **rotating-only** — you get a fresh IP on every request, with no sticky sessions. See [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, from $0.16/GB at scale. See [Residential Lite pricing](/pricing/residential-lite).

## Quickstart

1. Buy a Residential Lite plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above, adding a country to your username if needed.


---

# Unlimited Residential
Source: https://www.flashproxy.com/docs/products/unlimited-residential

# Unlimited Residential Proxies

FlashProxy's flagship plan: unmetered residential bandwidth with uncapped concurrency — built for max-scale operations where bandwidth predictability and unconstrained parallelism matter most.

## Specs

- **Coverage:** 201+ countries (country-level targeting)
- **Bandwidth:** unmetered (only the mbps throughput cap applies)
- **Concurrency:** uncapped
- **Protocols:** HTTP, SOCKS5
- **Sessions:** rotating or sticky (up to 2 hours)
- **Best for:** max-scale operations needing predictable bandwidth and unlimited parallelism

## Connect

**Gateway:** `unlim.flashproxy.io` — port **10507** (HTTP) / **10507** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@unlim.flashproxy.io:10507" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@unlim.flashproxy.io:10507" https://api.ipify.org
```

## Request parameters

Targeting and session options are encoded **into the username**, appended as a `-key-value` pair after your base username. Unlimited Residential is **country-level only**:

| Parameter      | Format                        | Example                    | Notes                                 |
| -------------- | ----------------------------- | -------------------------- | ------------------------------------- |
| Country        | `country-<ISO2>`              | `country-US`               | Comma-join several: `country-US,GB`   |
| Sticky session | `time-<minutes>-session-<id>` | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — United States
curl -x "http://USERNAME-country-US:PASSWORD@unlim.flashproxy.io:10507" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-time-30-session-a1b2c3d4:PASSWORD@unlim.flashproxy.io:10507" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Unmetered, available via a $20 trial. See [Unlimited Residential pricing](/pricing/unlimited-residential).

## Quickstart

1. Buy an Unlimited Residential plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above, adding a country to your username if needed.


---

# Datacenter
Source: https://www.flashproxy.com/docs/products/datacenter

# Datacenter Proxies

High-throughput US datacenter proxies at ~30 ms response — built for fast scraping and price monitoring on non-sensitive targets where speed and cost matter most.

## Specs

- **Pool:** 6,000+ USA IPs
- **Coverage:** US only (country-level targeting)
- **Typical response time:** ~30 ms
- **Protocols:** HTTP, SOCKS5 (SOCKS5 UDP ASSOCIATE supported)
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 50,000 concurrent connections (per-GB); 9,000 on the time-based Unlimited tier — higher on request
- **Best for:** fast scraping and e-commerce price monitoring

## Connect

**Gateway:** `dc.flashproxy.io` — port **777** (HTTP) / **666** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@dc.flashproxy.io:777" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@dc.flashproxy.io:666" https://api.ipify.org
```

## Request parameters

Datacenter is **US-only**, so there's no country parameter to set. Two options are still available, encoded **into the username**:

| Parameter         | Format                        | Example                    | Notes                                                                        |
| ----------------- | ----------------------------- | -------------------------- | ---------------------------------------------------------------------------- |
| Sticky session    | `time-<minutes>-session-<id>` | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP                                        |
| Pin a specific IP | `-ip-<address>`               | `-ip-0_0_0_0`              | Target one exact IP from the pool — see [Geo-targeting](/docs/geo-targeting) |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — a fresh US IP each request
curl -x "http://USERNAME:PASSWORD@dc.flashproxy.io:777" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-time-30-session-a1b2c3d4:PASSWORD@dc.flashproxy.io:777" https://api.ipify.org
```

```bash
# Pin one exact IP
curl -x "http://USERNAME-ip-0_0_0_0:PASSWORD@dc.flashproxy.io:777" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale, and a time-based Unlimited tier. See [Datacenter pricing](/pricing/datacenter).

## Quickstart

1. Buy a Datacenter plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above.


---

# ISP (US)
Source: https://www.flashproxy.com/docs/products/isp

# Shared ISP Proxies (US)

ISP-hosted US IPs that combine residential authenticity with datacenter-grade ~39 ms latency — built for ad verification, SEO, sneakers, and any workflow that needs residential trust at near-datacenter speed.

## Specs

- **Pool:** 22,000+ USA IPs
- **Coverage:** US only (country-level targeting)
- **Typical response time:** ~39 ms
- **Protocols:** HTTP, SOCKS5 (SOCKS5 UDP ASSOCIATE supported)
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 9,000 concurrent connections — higher on request
- **Best for:** ad verification, SEO monitoring, sneakers

## Connect

**Gateway:** `beta.flashproxy.io` — port **30** (HTTP) / **31** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@beta.flashproxy.io:30" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@beta.flashproxy.io:31" https://api.ipify.org
```

## Request parameters

Shared ISP (US) is **US-only**, so there's no country parameter to set. Two options are still available, encoded **into the username**:

| Parameter         | Format                        | Example                    | Notes                                                                        |
| ----------------- | ----------------------------- | -------------------------- | ---------------------------------------------------------------------------- |
| Sticky session    | `time-<minutes>-session-<id>` | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP                                        |
| Pin a specific IP | `-ip-<address>`               | `-ip-0_0_0_0`              | Target one exact IP from the pool — see [Geo-targeting](/docs/geo-targeting) |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — a fresh US IP each request
curl -x "http://USERNAME:PASSWORD@beta.flashproxy.io:30" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-time-30-session-a1b2c3d4:PASSWORD@beta.flashproxy.io:30" https://api.ipify.org
```

```bash
# Pin one exact IP
curl -x "http://USERNAME-ip-0_0_0_0:PASSWORD@beta.flashproxy.io:30" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale, and a time-based Unlimited tier. See [Shared ISP pricing](/pricing/isp).

## Quickstart

1. Buy a Shared ISP (US) plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above.


---

# ISP (EU)
Source: https://www.flashproxy.com/docs/products/isp-eu

# Shared ISP Proxies (EU)

The European counterpart to Shared ISP US — the same residential-trust-at-datacenter-speed profile, on European ISP IPs. Built for EU-geo ad verification, SEO, and account work that needs European ISP IPs.

## Specs

- **Coverage:** Netherlands available now; France, Italy, UK & Germany coming soon
- **Protocols:** HTTP, SOCKS5 (SOCKS5 UDP ASSOCIATE supported)
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 9,000 concurrent connections — higher on request
- **Latency:** see live, per-node latency at [status.flashproxy.com](https://status.flashproxy.com)
- **Best for:** EU-geo ad verification, SEO monitoring, account work

## Connect

**Gateway:** `eu-isp.flashproxy.io` — port **30** (HTTP) / **31** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@eu-isp.flashproxy.io:30" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@eu-isp.flashproxy.io:31" https://api.ipify.org
```

## Request parameters

Targeting and session options are encoded **into the username**. Shared ISP (EU) is **country-level** (Netherlands live, more European countries coming soon):

| Parameter         | Format                        | Example                    | Notes                                                                        |
| ----------------- | ----------------------------- | -------------------------- | ---------------------------------------------------------------------------- |
| Country           | `country-<ISO2>`              | `country-NL`               | Currently Netherlands                                                        |
| Sticky session    | `time-<minutes>-session-<id>` | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP                                        |
| Pin a specific IP | `-ip-<address>`               | `-ip-0_0_0_0`              | Target one exact IP from the pool — see [Geo-targeting](/docs/geo-targeting) |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — Netherlands
curl -x "http://USERNAME-country-NL:PASSWORD@eu-isp.flashproxy.io:30" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-country-NL-time-30-session-a1b2c3d4:PASSWORD@eu-isp.flashproxy.io:30" https://api.ipify.org
```

```bash
# Pin one exact IP
curl -x "http://USERNAME-ip-0_0_0_0:PASSWORD@eu-isp.flashproxy.io:30" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale, and a time-based Unlimited tier — identical pricing to Shared ISP US. See [Shared ISP EU pricing](/pricing/isp-eu).

## Quickstart

1. Buy a Shared ISP (EU) plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above.


---

# IPv6 Residential
Source: https://www.flashproxy.com/docs/products/ipv6-residential

# IPv6 Residential Proxies

IPv6-allocated residential IPs (US) with strong ~39 ms response times — built for sites that have shifted to IPv6-first infrastructure and operations that benefit from the larger address space.

## Specs

- **Pool:** ~160 octillion IPv6 addresses (US)
- **Coverage:** US only (country-level targeting)
- **Typical response time:** ~39 ms
- **Protocols:** HTTP, SOCKS5 (SOCKS5 UDP ASSOCIATE supported)
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 50,000 concurrent connections (per-GB); 9,000 on the time-based Unlimited tier — higher on request
- **Best for:** IPv6-first targets and large-address-space operations

## Connect

**Gateway:** `beta-ipv6.flashproxy.io` — port **30** (HTTP) / **31** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@beta-ipv6.flashproxy.io:30" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@beta-ipv6.flashproxy.io:31" https://api.ipify.org
```

## Request parameters

IPv6 Residential is **US-only**, so there's no country parameter to set. Two options are still available, encoded **into the username**:

| Parameter         | Format                                   | Example                    | Notes                                       |
| ----------------- | ---------------------------------------- | -------------------------- | ------------------------------------------- |
| Sticky session    | `time-<minutes>-session-<id>`            | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP       |
| Pin a specific IP | see [Geo-targeting](/docs/geo-targeting) | —                          | Target one exact IPv6 address from the pool |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — a fresh IPv6 each request
curl -x "http://USERNAME:PASSWORD@beta-ipv6.flashproxy.io:30" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-time-30-session-a1b2c3d4:PASSWORD@beta-ipv6.flashproxy.io:30" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale. See [IPv6 Residential pricing](/pricing/ipv6-residential).

## Quickstart

1. Buy an IPv6 Residential plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above.


---

# IPv6 Datacenter
Source: https://www.flashproxy.com/docs/products/ipv6-datacenter

# IPv6 Datacenter Proxies

The highest-throughput, lowest-cost option in the catalogue at ~30 ms response, with unlimited bandwidth on the IPv6 stack (US). Built for high-volume operations on IPv6-compatible targets where cost-per-request is the primary lever.

## Specs

- **Pool:** ~160 octillion IPv6 addresses (US)
- **Coverage:** US only (country-level targeting)
- **Typical response time:** ~30 ms
- **Protocols:** HTTP, SOCKS5 (SOCKS5 UDP ASSOCIATE supported)
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 50,000 concurrent connections (per-GB); 9,000 on the time-based Unlimited tier — higher on request
- **Best for:** high-volume work on IPv6-compatible targets

## Connect

**Gateway:** `v6-dc.flashproxy.io` — port **50** (HTTP) / **51** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@v6-dc.flashproxy.io:50" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@v6-dc.flashproxy.io:51" https://api.ipify.org
```

## Request parameters

IPv6 Datacenter is **US-only**, so there's no country parameter to set. Two options are still available, encoded **into the username**:

| Parameter         | Format                                   | Example                    | Notes                                       |
| ----------------- | ---------------------------------------- | -------------------------- | ------------------------------------------- |
| Sticky session    | `time-<minutes>-session-<id>`            | `time-30-session-a1b2c3d4` | Up to 120 min; omit for a rotating IP       |
| Pin a specific IP | see [Geo-targeting](/docs/geo-targeting) | —                          | Target one exact IPv6 address from the pool |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — a fresh IPv6 each request
curl -x "http://USERNAME:PASSWORD@v6-dc.flashproxy.io:50" https://api.ipify.org
```

```bash
# Sticky — hold the same IP for 30 minutes
curl -x "http://USERNAME-time-30-session-a1b2c3d4:PASSWORD@v6-dc.flashproxy.io:50" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale, and a time-based Unlimited tier. See [IPv6 Datacenter pricing](/pricing/ipv6-datacenter).

## Quickstart

1. Buy an IPv6 Datacenter plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above.


---

# Mobile
Source: https://www.flashproxy.com/docs/products/mobile

# Mobile Proxies

Authentic 4G / 5G mobile carrier IPs across 115 countries at ~387 ms response — the cleanest IP reputation in the FlashProxy catalogue. Built for mobile app testing and account creation where mobile-specific signals are required.

## Specs

- **Pool:** millions of mobile IPs active daily
- **Coverage:** 115 countries
- **Typical response time:** ~387 ms
- **Protocols:** HTTP, SOCKS5
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 50,000 concurrent connections
- **Best for:** mobile app testing, account creation

## Connect

**Gateway:** `adam.flashproxy.io` — port **8080** (HTTP) / **1080** (SOCKS5).

```bash
# Rotating — a fresh IP on every request
curl -x "http://USERNAME:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@adam.flashproxy.io:1080" https://api.ipify.org
```

## Request parameters

Targeting and session options are encoded **into the username**, appended as a `-key-value` pair after your base username. Mobile supports **country** and **carrier (ASN)** targeting:

| Parameter      | Format                            | Example                      | Notes                               |
| -------------- | --------------------------------- | ---------------------------- | ----------------------------------- |
| Country        | `country-<ISO2>`                  | `country-US`                 | Comma-join several: `country-US,GB` |
| Carrier (ASN)  | `asn-<number>`                    | `asn-21928`                  | Any carrier ASN within the country  |
| Sticky session | `session-<id>-time-<long\|short>` | `session-a1b2c3d4-time-long` | Omit for a rotating IP              |

For the complete reference — every accepted value — see the [API reference](https://rapi.flashproxy.com/docs).

## Examples

```bash
# Rotating — United States
curl -x "http://USERNAME-country-US:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# Target a specific carrier (ASN)
curl -x "http://USERNAME-country-US-asn-21928:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

```bash
# Sticky — hold the same mobile IP across the session
curl -x "http://USERNAME-country-US-session-a1b2c3d4-time-long:PASSWORD@adam.flashproxy.io:8080" https://api.ipify.org
```

## Sessions

Use **rotating** for maximum IP diversity or **sticky** to keep the same IP across a session — see [Rotating & sticky](/docs/sessions).

## Pricing

Per-GB, with volume discounts as you scale. See [Mobile pricing](/pricing/mobile).

## Quickstart

1. Buy a Mobile plan in the [dashboard](/dashboard).
2. Copy your username and password.
3. Use the connection string above, adding country or carrier targeting as needed.


---

# Dedicated ISP
Source: https://www.flashproxy.com/docs/products/dedicated-isp

# Dedicated ISP Proxies

In-house dedicated, on-demand ISP IPs — you buy specific IPs for exclusive use (not a shared pool) at ~40 ms response, with unlimited bandwidth and full subnet diversity. Built for long-running, identity-bound operations like account warming and ticketing.

## Specs

- **Model:** dedicated IPs sold on-demand (one user owns the IP for the duration)
- **Coverage:** 5 countries — US, Germany, Canada, UK, Australia
- **Bandwidth:** unlimited
- **Typical response time:** ~40 ms
- **Protocols:** HTTP, SOCKS5
- **Sessions:** rotating or sticky (up to 2 hours)
- **Concurrency:** up to 9,000 concurrent connections — higher on request
- **Best for:** account warming, ticketing, identity-bound workflows
- **Includes:** full subnet diversity

## Connect

Dedicated ISP has no fixed gateway — each purchased IP has its own host and port, shown in your [dashboard](/dashboard) after purchase. Substitute them below.

```bash
# HTTP
curl -x "http://USERNAME:PASSWORD@<your-dedicated-host>:<port>" https://api.ipify.org
```

```bash
# SOCKS5
curl -x "socks5://USERNAME:PASSWORD@<your-dedicated-host>:<port>" https://api.ipify.org
```

## Request parameters

**None.** You **own** the IP — connect to the host:port assigned to your plan (shown in the [dashboard](/dashboard)) and every request exits that IP. There are no country, session, or IP-targeting flags to add to the username. Your country is chosen **at purchase** from the 5 supported locations (US, DE, CA, UK, AU).

## Sessions

Your dedicated IP is **static** for the duration — every request comes out of the same IP, so there's nothing to rotate or pin. If your plan includes multiple IPs (subnet diversity), you can distribute traffic across them.

## Pricing

Per-IP, with unlimited bandwidth. See [Dedicated ISP pricing](/pricing/dedicated-isp).

## Quickstart

1. Buy a Dedicated ISP plan in the [dashboard](/dashboard), choosing your country.
2. Copy your username, password, and the host:port for your IP.
3. Use the connection string above with your dedicated host and port.


---

# Troubleshooting
Source: https://www.flashproxy.com/docs/troubleshooting

# Troubleshooting

Quick fixes for the most common connection problems.

## `407 Proxy Authentication Required`

Your username or password is **stale or invalid**. Re-check the pair on your plan's page in the [dashboard](/dashboard), and regenerate the credentials if they don't match. Update every client after regenerating. See [Authentication](/docs/authentication).

## Connection timeout

The client can't reach the gateway. Check that:

- the **host** matches your product's gateway (see the per-product guide),
- the **port** is right — **8080** by default, **30/31** for Datacenter and Shared ISP, **10507** for Unlimited Residential,
- the **format** is correct — `http://USER:PASS@host:port` or `socks5://USER:PASS@host:port` ([Proxy formats](/docs/proxy-formats)).

## Slow responses

Latency is product-dependent. Datacenter and ISP products respond fastest; Residential and Mobile trade speed for IP authenticity. If response time matters more than IP type, match your workload to a faster product — see the product guides and [pricing](/pricing).

## IP not rotating

If you're getting the same IP repeatedly, you're likely on a **sticky** session. Switch to **rotating** for a fresh IP per request. Remember **Residential Lite is rotating-only**. See [Rotating & sticky sessions](/docs/sessions).

## Geo-targeting not working

Confirm the targeting depth you're asking for is **available on your product**. Residential Lite and Unlimited Residential are **country-level only**; Datacenter, Shared ISP, and IPv6 products are country-level (and US-only where noted). See [Geo-targeting](/docs/geo-targeting).

> **Still stuck?** [Talk to a proxy expert](/contact) — support is 24/7.


---

# FAQ
Source: https://www.flashproxy.com/docs/faq

# FAQ

## Is using FlashProxy legal?

Proxies are a legitimate tool. You're responsible for using FlashProxy lawfully and within our [Acceptable Use Policy](/docs/acceptable-use) — the prohibited-use boundaries are set out in Section 9 of the [Terms](/terms). Breaking them can lead to suspension or termination.

## Are the IPs ethically sourced?

Yes. FlashProxy's residential IP pool is built on **ISP partnerships** rather than consumer-side SDKs or malware-bundled proxy clients, with a documentable provenance chain.

## How does billing work?

It depends on the product:

- **Per-GB** for metered plans (Residential, Residential Lite, Datacenter, Mobile, Shared ISP, IPv6).
- **Flat / unmetered (throughput-throttled)** for Unlimited Residential.
- **Per-IP** for Dedicated ISP.

Pay by **card** or **crypto**. See [pricing](/pricing).

## What's the difference between the products?

Each product trades off IP type, speed, geo depth, and price differently. See the per-product guides linked from the [docs home](/docs/index), or the [pricing](/pricing) pages.

## Is IPv6 supported?

Yes — **IPv6 Residential** and **IPv6 Datacenter** (US). See their product guides.

## What's a sticky session?

A session that keeps the **same IP** across all its requests, configurable from **1 minute up to 2 hours**. The alternative is **rotating** — a fresh IP per request. See [Sessions](/docs/sessions).

## How do I rotate IPs?

Use a **rotating** session — every request gets a fresh IP automatically. See [Sessions](/docs/sessions).

## Is there a free trial?

The **14-day free trial is currently paused and returning soon**. Unlimited Residential is available via a $20 trial.

> **Need more?** [Talk to a proxy expert](/contact) — 24/7 support.


---

# Acceptable use
Source: https://www.flashproxy.com/docs/acceptable-use

# Acceptable Use Policy

FlashProxy's Acceptable Use Policy is **Section 9 of the [Terms of Service](/terms)**. Using FlashProxy means agreeing to it.

## Prohibited uses

You may not use FlashProxy for:

- Illegal activity of any kind
- Unauthorized access to systems or accounts
- Distributing malware
- Spam, phishing, or fraud
- Harassment
- Intellectual-property infringement
- Harm to minors
- Circumventing security controls
- Interfering with or disrupting systems
- Violating the terms of service of the targets you connect to
- Unauthorized resale of the service
- Sharing your credentials

## Consequences

Violations lead to **immediate suspension or termination of your account without refund** (subject to the KYC-decline carve-out in the [KYC Policy](/kyc-policy)). FlashProxy reserves the right to refer matters to law enforcement.

> **Report abuse:** email [contact@flashproxy.io](mailto:contact@flashproxy.io). See the full policy at [/terms](/terms).


---

# Compliance & privacy
Source: https://www.flashproxy.com/docs/compliance

# Compliance

A public summary of how FlashProxy handles legal and data-protection obligations.

## Jurisdiction

FlashProxy is operated by **FlashProxy B.V.**, a Dutch private limited company incorporated in the **Netherlands**.

## GDPR

FlashProxy is **GDPR compliant**. Data-subject rights are honored, sub-processors are listed in the [Privacy Policy](/privacy), and Standard Contractual Clauses (SCCs) cover international transfers.

## KYC

FlashProxy operates a tiered KYC model — baseline email verification for all users, with risk-triggered escalated verification. Full details are in the public [KYC Policy](/kyc-policy).

## Data retention

| Data             | Retention                    |
| ---------------- | ---------------------------- |
| Account data     | Account lifetime + 2 years   |
| Transactions     | 7 years (Dutch tax law)      |
| Security records | 6 months – 2 years           |
| KYC documents    | Account lifetime + 12 months |

See the [Privacy Policy](/privacy) for the full statement.

## Legal documents

- [Terms of Service](/terms) — includes the Refund Policy and Acceptable Use Policy
- [Privacy Policy](/privacy)
- [Cookie Policy](/cookies)
- [KYC Policy](/kyc-policy)

> **Questions?** Contact [contact@flashproxy.io](mailto:contact@flashproxy.io) for legal, privacy, or data-subject requests.