# Geo-Targeting

### Overview

Geo-targeting allows you to route requests through proxies in specific countries, states, or cities. This is essential for:

* Accessing geo-restricted content
* Testing localized experiences
* Price comparison across regions
* Ad verification by location

### Supported Proxy Types

| Product     | Country | State | City |
| ----------- | ------- | ----- | ---- |
| Datacenter  | Yes     | No    | No   |
| ISP         | Yes     | No    | No   |
| Residential | Yes     | Yes   | Yes  |
| IPv6        | Yes     | No    | No   |

### Using Geo-Targeting

#### In Proxy Generation

```
POST /proxies/generate
```

```json
{
  "format": "{ip}:{port}:{user}:{pass}",
  "country": "US",
  "state": "California",
  "city": "Los Angeles",
  "quantity": 10
}
```

#### In Proxy Username

You can also specify location in the username:

```
username-country-US-state-California-city-LosAngeles:password
```

### Country Codes

Use ISO 3166-1 alpha-2 codes:

| Code | Country        |
| ---- | -------------- |
| `US` | United States  |
| `GB` | United Kingdom |
| `DE` | Germany        |
| `NL` | Netherlands    |
| `CA` | Canada         |
| `FR` | France         |
| `JP` | Japan          |
| `AU` | Australia      |

#### Get Available Countries

```
GET /countries
```

Returns all available countries grouped by product type.

### State Targeting

For US states, use full state names (residential proxies only):

```json
{
  "country": "US",
  "state": "California"
}
```

Common US states:

* California
* New York
* Texas
* Florida
* Illinois

### City Targeting

Specify city name along with country (residential proxies only):

```json
{
  "country": "US",
  "state": "California",
  "city": "Los Angeles"
}
```

Popular cities:

* New York
* Los Angeles
* Chicago
* London
* Tokyo
* Sydney

> City availability depends on our IP pool. Not all cities are available in all countries.

### Worldwide / Random

Omit location parameters to get random worldwide IPs:

```json
{
  "format": "{ip}:{port}:{user}:{pass}",
  "quantity": 10
}
```

Or explicitly use `WW`:

```json
{
  "country": "WW"
}
```

### Best Practices

* **Start broad** — Begin with country-level targeting
* **Check availability** — Use `/countries` to see available locations
* **Cache country data** — Country list doesn't change often
* **Handle fallbacks** — If a specific city is unavailable, fall back to state or country
* **Monitor success rates** — Some locations may have fewer IPs


---

# 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.plainproxies.com/concepts/geo-targeting.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.