areas.md

Справочник регионов

‼️ Внимание! Значения в справочниках могут поменяться в любой момент. Не нужно завязываться на них.

• Дерево всех регионов
• Справочник регионов, начиная с указанного
• Справочник стран

Смотрите также

• Подсказки по полному дереву регионов и листам дерева регионов

Дерево всех регионов

GET /areas возвращает древовидный список всех регионов с указанием названия региона, его идентификатором и ссылкой на родительский регион parent_id.

[
    {
        "name": "Украина",
        "id": "5",
        "parent_id": null,
        "areas": [
            {
                "name": "Киев",
                "id": "115",
                "parent_id": "5",
                "areas": []
            }
        ]
    }
]

Пример: https://api.hh.ru/areas

Справочник регионов, начиная с указанного

GET /areas/{area_id} вернёт древовидный список регионов, начиная с указанного.

Пример: https://api.hh.ru/areas/1146

Справочник стран

GET /areas/countries вернёт подмножество регионов, являющихся странами.

Пример ответа:

[
  {
    "url": "https://api.hh.ru/areas/113",
    "id": "113",
    "name": "Россия"
  },
  {
    "url": "https://api.hh.ru/areas/5",
    "id": "5",
    "name": "Украина"
  }
]