> For the complete documentation index, see [llms.txt](https://docs.dataimpulse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dataimpulse.com/proxies/targeting/geohash-targeting.md).

# Geohash Targeting

Target a specific area on the map by geohash. Set it up in the Dashboard or with the geohash parameter in your proxy login.

Geohash Targeting lets you get IPs from a specific area on the map, such as a single neighborhood of a city, instead of a whole country or city.

{% embed url="<https://youtu.be/7Ak921ALcMI>" %}

{% hint style="warning" %}
Traffic routed through Geohash Targeting is billed at double the standard rate.

Premium Residential Pool: no additional charges. Geohash Targeting is included in the base price.
{% endhint %}

#### What is a geohash

A geohash is a short code for a square area on the map: the longer the code, the smaller the area. DataImpulse supports geohashes of up to 5 characters.

| Geohash | Area                                    |
| ------- | --------------------------------------- |
| `d`     | A large part of North and South America |
| `dr`    | The northeastern US                     |
| `dr5`   | New York and its surroundings           |
| `dr5ru` | Midtown Manhattan, New York             |

A geohash uses the digits `0`–`9` and the letters `b`–`z`, except `i`, `l` and `o`. The letter `a` is not used.

To find the code for your area, use any geohash map: zoom in to the area you need and copy the code of its square.

#### How to set up Geohash Targeting in the Dashboard

1. Open your plan and scroll down to **Proxy Configuration**.
2. Select **Geohash Targeting**.
3. Enter the code in the **Geohash** field, for example `dr5ru`.
4. Optionally, set **Country**, **ASN** and **Minimum Geo Pool** (see below).
5. Click **Save configuration**, then **Confirm and save changes**.

The geohash is added to your proxy login in the **Basic URL example** and in the **Proxy List**:

```
curl -x "http://login__geohash.dr5ru:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

{% hint style="info" %}
The settings are applied only after you click **Save configuration** and confirm.
{% endhint %}

#### Fields

| Field                | Required | Description                                                                                                                                                                                                                                                                                   |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Geohash**          | Yes      | The area to target, up to 5 characters.                                                                                                                                                                                                                                                       |
| **Country**          | No       | The list shows only the countries inside your geohash, with the number of available IPs. Use it when your area crosses a border: a geohash square can cover more than one country, and this keeps every IP in the country you need.                                                           |
| **ASN**              | No       | Target a specific provider inside your area. A **Country** must be selected to use ASN.                                                                                                                                                                                                       |
| **Minimum Geo Pool** | No       | Unlocks after you enter a geohash. By default, you only get IPs from inside the square. Enter the number of IPs you need, and we'll expand the search step by step to the area around the square until there are at least that many — if needed, up to the whole country. Whole numbers only. |

**Example:** the `dr5ru` square has about 1,500 IPs. If your task needs to rotate through at least 5,000 different IPs, set **Minimum Geo Pool** to `5000`. Some of the IPs will then come from neighboring areas, for example Brooklyn (`dr5qv`).

Rotation interval, Anonymous filter and Exclude ASN work with Geohash Targeting the same way as with other targeting options.

#### How to check where your IP is

Add the `Accept-X-Proxy-Headers` proxy header to your request. The proxy response will include the exit IP, its country, city and geohash:

```
curl -x "http://login__geohash.dr5ru:password@gw.dataimpulse.com:823" \
  --proxy-header "Accept-X-Proxy-Headers: X-Proxy-IP, X-Proxy-Country, X-Proxy-City, X-Proxy-Geohash" \
  -s -D - -o /dev/null https://api.ipify.org/
```

Response:

```
HTTP/1.1 200 OK
X-Proxy-IP: 48.45.161.37
X-Proxy-Country: US
X-Proxy-City: New York
X-Proxy-Geohash: dr5ru-US
```

You can also check the IP with any IP geolocation service.

#### Errors

| Response                | Reason and what to do                                                                                                 |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `407 COUNTRY_REQUERIED` | ASN is set without a country. Select a **Country** or add it to the geohash, for example `geohash.dr5ru-us;asn.7922`. |
| `503 NO_RAY`            | No IPs are available for these settings. Use a shorter geohash, set **Minimum Geo Pool**, or remove other filters.    |

An invalid geohash doesn't return an error: it is ignored, and the request is sent without geohash targeting.

To set Geohash Targeting manually in your code, see the [Geohash](https://docs.dataimpulse.com/proxies/parameters/geohash.md) parameter.


---

# 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://docs.dataimpulse.com/proxies/targeting/geohash-targeting.md?ask=<question>&goal=<user_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.
