> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catproxy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Параметры геотаргетинга

> Узнайте, как настроить таргетинг на конкретные страны, штаты, города, почтовые индексы и ASN, добавив параметры к имени пользователя прокси.

Геотаргетинг позволяет вам контролировать географическое положение IP-адреса выхода для ваших запросов. Это необходимо для доступа к контенту с географическими ограничениями, сбора локализованных данных и проверки рекламы.

Вы можете управлять геотаргетингом, добавляя специальные параметры непосредственно к имени пользователя вашего прокси.

**Базовое имя пользователя:** `cat-customer-a1b2-proxy-my_scraper`

**Имя пользователя с геотаргетингом:** `cat-customer-a1b2-proxy-my_scraper-country-de-city-berlin`

***

## Логика таргетинга

Наш шлюз обрабатывает геопараметры по следующим правилам:

* **Специфичность побеждает:** всегда используется наиболее конкретный параметр. Например, если вы укажете и `-city`, и `-country`, приоритет будет отдан городу.
* **Зависимости:** некоторые параметры требуют других. Например, вы не можете нацелиться на город, не указав страну.
* **Взаимоисключаемость:** вы можете использовать либо **географические** параметры (`country`, `state`, `city`, `zip`), либо **сетевые** (`asn`, `isp`). Вы не можете использовать оба варианта в одном запросе.

***

## Параметры географического таргетинга

Эти параметры управляют физическим местоположением прокси.

### Страна (`-country`)

Это самый распространённый параметр таргетинга. Он позволяет выбрать IP-адрес из определённой страны.

<Accordion title="Подробности параметра">
  * **Формат:** `-country-[код]`
  * **Значение:** 2-буквенный код страны ISO 3166-1 alpha-2 (например, `us`, `de`, `gb`).
  * **Зависимости:** нет.
  * **Пример имени пользователя:** `...-my_scraper-country-de`
  * **Результат:** ваш запрос будет направлен через случайный IP в Германии.
  * **[Посмотреть полный список поддерживаемых стран](/ru/data/countries)**
</Accordion>

### Штат / Регион (`-state`)

Таргетинг на определённый штат или регион в пределах выбранной страны.

<Accordion title="Подробности параметра">
  * **Формат:** `-state-[код]`
  * **Значение:** название штата или региона (например, `california` для Калифорнии, `newyork` для Нью-Йорка).
  * **Зависимости:** требуется, чтобы `-country` присутствовал в имени пользователя.
  * **Пример имени пользователя:** `...-my_scraper-country-us-state-california`
  * **Результат:** ваш запрос будет направлен через IP в Калифорнии.
  * **[Посмотреть полный список штатов США](/ru/data/states)**
</Accordion>

### Город (`-city`)

Таргетинг на определённый город.

<Accordion title="Подробности параметра">
  * **Формат:** `-city-[название]`
  * **Значение:** название города в нижнем регистре, без пробелов (например, `newyork`, `sanfrancisco`).
  * **Зависимости:** требуется параметр `-country`. Может сочетаться с параметром `-state` для уточнения.
  * **Пример (простой):** `...-my_scraper-country-fr-city-paris`
  * **Пример (со штатом):** `...-my_scraper-country-us-state-il-city-springfield`
  * **Результат:** ваш запрос будет направлен через IP-адрес в указанном городе.
  * **Примечание о двусмысленности:** если в стране есть несколько городов с одинаковым названием, вы **должны** указать параметр `-state` для уточнения. В противном случае шлюз вернет ошибку.
</Accordion>

### Почтовый индекс (`-zip`)

Таргетинг на определённый почтовый индекс. Идеально подходит для сбора гиперлокальных данных.

<Accordion title="Подробности параметра">
  * **Формат:** `-zip-[код]`
  * **Значение:** почтовый индекс.
  * **Зависимости:** требуется `-country`. Может сочетаться с `-state` и `-city` для более точной адресации.
  * **Пример имени пользователя:** `...-my_scraper-country-us-zip-90210`
  * **Результат:** ваш запрос будет направлен через IP в районе Беверли-Хиллз.
</Accordion>

***

## Параметры сетевого таргетинга

Эти параметры управляют сетевым происхождением прокси. Они взаимоисключающие со всеми географическими параметрами.

### ASN (`-asn`)

Таргетинг на определённого интернет-провайдера (ISP) по его автономному системному номеру (ASN).

<Accordion title="Подробности параметра">
  * **Формат:** `-asn-[номер]`
  * **Значение:** числовой ASN провайдера (например, `7922` для Comcast).
  * **Зависимости:** взаимоисключающий со всеми географическими параметрами (`-country`, `-state`, `-city`, `-zip`).
  * **Пример имени пользователя:** `...-my_scraper-asn-7922`
  * **Результат:** ваш запрос будет направлен через IP, принадлежащий сети Comcast.
  * **Совет:** вы можете найти номера ASN для основных провайдеров на сайтах вроде [ipinfo.io](https://ipinfo.io/AS24940?lookup_source=search-bar).
</Accordion>

### ISP (`-isp`) - только для мобильных прокси

Таргетинг на определённого оператора мобильной связи по его цифровому коду ISP. Доступно только для мобильных прокси.

<Accordion title="Подробности параметра">
  * **Формат:** `-isp-[код]`
  * **Значение:** цифровой код мобильного оператора, указанный в справочном списке провайдеров (например, `310260` для T-Mobile US).
  * **Зависимости:** взаимоисключающий со всеми географическими параметрами (`-country`, `-state`, `-city`, `-zip`). Доступно только на мобильных прокси.
  * **Пример имени пользователя:** `...-my_scraper-isp-310260`
  * **Результат:** ваш запрос будет направлен через IP-адрес в сети T-Mobile US.
  * **Примечание:** код провайдера - это числовой идентификатор, а не название. Используйте код из селектора провайдеров в панели управления прокси.
</Accordion>