---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/dictionaries/getGeoRegions.md
  - https://yandex.com/dev/direct/doc/ru/dictionaries/getGeoRegions.md
  - href: ru/dictionaries/getGeoRegions.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/dictionaries/getGeoRegions.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# getGeoRegions

Возвращает список регионов, доступных для таргетинга.

## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "getGeoRegions",
  "params" : { /* required */
    "Page" : {
      "Limit" : (long),
      "Offset" : (long)
    },
    "SelectionCriteria" : { /* required */
      "Name" : (string),
      "RegionIds" : [ (long) ],
      "ExactNames" : [ (string) ]
    },
    "FieldNames" : [ ("GeoRegionId" |"GeoRegionName"|"ParentGeoRegionNames") ] /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||
||
**Структура params (для JSON) / GetRequest (для SOAP)**
|
>
|
>
|
>
||
||
`Page`
|
LimitOffset
|
Структура, задающая страницу при [постраничной выборке](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html#page) данных.
|
Нет
||
||
`SelectionCriteria`
|
GeoRegionsSelectionCriteria
|
Критерий отбора регионов.

Необходимо передать хотя бы один из параметров: `Name`, `RegionIds` или `ExactNames`.

Если в запросе передан параметр:

- `Name` – метод вернет результаты по регионам с похожим названием.
- `RegionIds` – метод вернет результаты по идентификаторам регионов.
- `ExactNames` – метод вернет результаты по точным названиям регионов.
|
Да
||
||
`FieldNames`
|
array of AdFieldEnum
|
Имена параметров верхнего уровня, которые требуется получить.
|
Да
||
||
**Структура GeoRegionsSelectionCriteria**
|
>
|
>
|
>
||
||
`Name`
|
string
|
Отбирать регионы с похожим названием.
|
Нет, если указан `RegionIds` или `ExactNames`.
||
||
`RegionIds`
|
array of long
|
Отбирать регионы с указанными идентификаторами.
|
Нет, если указан `Name` или `ExactNames`.
||
||
`ExactNames`
|
array of string
|
Отбирать регионы по точным названиям.
|
Нет, если указан `Name` или `RegionIds`.
||
|# 


## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result" : { /* required */
    "LimitedBy" : (long),
    "GeoRegions" : [{
      "GeoRegionId" : (long),
      "GeoRegionName" : (string),
      "ParentGeoRegionNames" : { /* nillable */
        "Items" : [ (string) ] /* required */
      }
    }, .. (unbounded)]
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||
||
**Структура result (для JSON) / GetResponse (для SOAP)**
|
>
|
>
||
||
`LimitedBy`
|
long
|
Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел [Постраничная выборка](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html#page).
||
||
`GeoRegions`
|
array of GeoRegionsGetItem
|
Список регионов.
||
||
**Структура GeoRegionsGetItem**
|
>
|
>
||
||
`GeoRegionId`
|
long
|
Идентификатор региона.
||
||
`GeoRegionName`
|
string
|
Название региона на языке, указанном в запросе в HTTP-заголовке [Accept-Language](https://yandex.ru/dev/direct/doc/dg/concepts/headers.html#accept-language).
||
||
`ParentGeoRegionNames`
|
array of string
|
Массив названий вышестоящих регионов.
||
|#