Регионы и города hh.ru с кодами

Каталог регионов hh со служебными кодами area_id — теми самыми, которые принимает API и фильтры поиска. Начните печатать название, таблица отфильтруется мгновенно.

Что такое area_id и зачем он нужен

Внутри hh каждый регион и населённый пункт имеет числовой идентификатор. Он появляется в адресе страницы поиска, передаётся в API и используется во всех фильтрах. Знать его полезно в двух случаях: если вы обращаетесь к API hh программно и если настраиваете автоматический поиск вакансий, где регион задаётся кодом, а не названием.

Каталог устроен как дерево: страна содержит регионы, регион — города и районы. Поэтому у одного и того же названия может быть несколько записей: в колонке «входит в» видно, о каком именно населённом пункте речь. Тёзки в России встречаются часто, и без вышестоящего региона различить их невозможно.

Особенность кода 113

Отдельно стоит запомнить код 113 — это Россия целиком. В фильтрах он означает «искать по всей стране», а не по конкретному городу. Если вы задаёте регион программно и хотите охватить весь рынок, нужен именно он, а не перечисление всех регионов списком.

Порядок в таблице

Строки отсортированы по числовому коду, а не по алфавиту. Это не случайность: коды выдавались по мере добавления регионов, поэтому крупнейшие города имеют самые маленькие номера и оказываются наверху. Алфавитный порядок вывел бы в начало списка малые населённые пункты, а искать в справочнике обычно нужно города.