GetRegions (Live)

Returns a list of regions registered in Yandex Direct.
Information about regions can be useful when analyzing campaign statistics, forecasting impressions and clicks (using the CreateNewForecast method), and creating or editing ads.

New in the Live 4 version

Added the RegionType parameter.

Input data

The input data structure in JSON is shown below.

{
   "method": "GetRegions"
}

Output data

The method returns an array of RegionInfo objects, each of which corresponds to a single region. The output data structure in JSON is shown below.

{
   "data": [
      {  /* RegionInfo */
         "RegionID": (int),
         "ParentID": (int),
         "RegionName": (string),
         "RegionType": (string)
      }
      ...
   ]
}

Parameters are described below.

Parameter

Description

RegionInfo object

RegionID

Region ID in Yandex Direct.

ParentID

ID of the higher-level region.

RegionName

Name of the region.

RegionType

Type of region. Possible values: Continent, Region, Country, Administrative area, City, Village.