# Поиск региона Разберем принцип взаимодействия с API на самом простом примере – поиске региона в справочнике регионов. Например, нам требуется найти регион Яндекса с названием “Москва”. Для поиска указанного региона по названию необходимо выполнить GET-запрос на конечную точку [https://moab-apis.ru/api/v1/region/yandex](https://docs.moab.tools/%D0%A0%D0%B0%D0%B7%D0%B1%D0%B5%D1%80%D0%B5%D0%BC%20%D0%BF%D1%80%D0%B8%D0%BD%D1%86%D0%B8%D0%BF%20%D0%B2%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F%20%D1%81%20API%20%D0%BD%D0%B0%20%D1%81%D0%B0%D0%BC%D0%BE%D0%BC%20%D0%BF%D1%80%D0%BE%D1%81%D1%82%D0%BE%D0%BC%20%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D0%B5%20%E2%80%93%20%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B5%20%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%20%D0%B2%20%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA%D0%B5%20%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%BE%D0%B2.%20%D0%9D%D0%B0%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80,%20%D0%BD%D0%B0%D0%BC%20%D1%82%D1%80%D0%B5%D0%B1%D1%83%D0%B5%D1%82%D1%81%D1%8F%20%D0%BD%D0%B0%D0%B9%D1%82%D0%B8%20%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%20%D0%AF%D0%BD%D0%B4%D0%B5%D0%BA%D1%81%D0%B0%20%D1%81%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D0%BC%20%E2%80%9C%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0%E2%80%9D.%20%D0%94%D0%BB%D1%8F%20%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B0%20%D1%83%D0%BA%D0%B0%D0%B7%D0%B0%D0%BD%D0%BD%D0%BE%D0%B3%D0%BE%20%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%20%D0%BF%D0%BE%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D1%8E%20%D0%BD%D0%B5%D0%BE%D0%B1%D1%85%D0%BE%D0%B4%D0%B8%D0%BC%D0%BE%20%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D1%8C%20GET-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%20%D0%BD%D0%B0%20%D0%BA%D0%BE%D0%BD%D0%B5%D1%87%D0%BD%D1%83%D1%8E%20%D1%82%D0%BE%D1%87%D0%BA%D1%83%20https:/moab-apis.ru/api/v1/region/yandex.%20%D0%92%20GET-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B5%20query%20%D0%BD%D1%83%D0%B6%D0%BD%D0%BE%20%D1%83%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%20(%D0%B8%D0%BB%D0%B8%20%D1%87%D0%B0%D1%81%D1%82%D1%8C%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)%20%D1%80%D0%B5%D0%B3%D0%B8%D0%BE%D0%BD%D0%B0%20(%D1%80%D0%B5%D0%B3%D0%B8%D1%81%D1%82%D1%80%20%D1%81%D0%B8%D0%BC%D0%B2%D0%BE%D0%BB%D0%BE%D0%B2%20%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BD%D0%B5%20%D0%B8%D0%BC%D0%B5%D0%B5%D1%82),%20%D0%BD%D0%B0%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80%20https:/moab-apis.ru/api/v1/region/yandex?query=%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0.%20%D0%92%20%D0%BE%D1%82%D0%BB%D0%B8%D1%87%D0%B8%D0%B5%20%D0%BE%D1%82%20%D0%BE%D1%81%D1%82%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D1%85%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2,%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B%20%D0%BA%20%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA%D0%B0%D0%BC%20%D0%BD%D0%B5%20%D1%82%D1%80%D0%B5%D0%B1%D1%83%D1%8E%D1%82%20%D0%BE%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE%20%D1%83%D0%BA%D0%B0%D0%B7%D0%B0%D0%BD%D0%B8%D1%8F%20%D0%B7%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B0%20X-Api-Key,%20%D0%BF%D0%BE%D1%8D%D1%82%D0%BE%D0%BC%D1%83%20%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE%20%D0%BF%D1%80%D0%BE%D1%81%D1%82%D0%BE%20%D0%B2%D0%BF%D0%B8%D1%81%D0%B0%D1%82%D1%8C%20%D1%8D%D1%82%D0%BE%D1%82%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%20%D0%B2%20%D0%B0%D0%B4%D1%80%D0%B5%D1%81%D0%BD%D1%83%D1%8E%20%D1%81%D1%82%D1%80%D0%BE%D0%BA%D1%83%20%D0%B1%D1%80%D0%B0%D1%83%D0%B7%D0%B5%D1%80%D0%B0%20%D0%B8%20%D0%BF%D0%BE%D1%81%D0%BC%D0%BE%D1%82%D1%80%D0%B5%D1%82%D1%8C%20%D0%BD%D0%B0%20%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82:). В GET-параметре query нужно указать название (или часть названия) региона (регистр символов значения не имеет), например [https://moab-apis.ru/api/v1/region/yandex?query=москва](https://moab-apis.ru/api/v1/region/yandex?query=%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B0). Запросы к справочнику регионов, как и остальные запросы, требуют наличия заголовка X-Api-Key, поэтому просто выполнить в браузере этот запрос не получится. В результате успешного выполнения запроса вы получите следующий результат: [![image.png](https://docs.moab.tools/uploads/images/gallery/2025-10/scaled-1680-/yYfimage.png)](https://docs.moab.tools/uploads/images/gallery/2025-10/yYfimage.png) Как видно из скриншота, вам возвращается JSON-массив со списком всех регионов, в названии которых было найдено слово “москва”. Нужный вам регион вы можете найти путем сравнения названий в вашем клиентском коде. Чем точнее вы укажете название региона – тем меньше результатов будет вам выдано. JSON-структура ответа обычным текстом выглядит вот так: ```json [   {     "name": "Аничково, Москва и Московская область, Щелковский район",     "code": "117175"   },   {     "name": "Барвиха, Москва и Московская область, Одинцовский район",     "code": "21652"   },   {     "name": "Быково, Москва и Московская область, Раменский район",     "code": "10718"   },   {     "name": "Железнодорожный, Москва и Московская область",     "code": "21622"   },   {     "name": "Заречье, Москва и Московская область, Одинцовский район",     "code": "21653"   },   {     "name": "Монино, Москва и Московская область, Щелковский район",     "code": "21636"   },   {     "name": "Москва",     "code": "213"   },   … ] ``` Найдя необходимый регион в справочнике, вы можете использовать значение поля code в дальнейших запросах к Yandex Wordstat и другим сервисам, которые связаны с Яндексом. В ответ на запрос вам может вернуться какой-то HTTP-код ответа из этого списка: [![image.png](https://docs.moab.tools/uploads/images/gallery/2025-10/scaled-1680-/Pwuimage.png)](https://docs.moab.tools/uploads/images/gallery/2025-10/Pwuimage.png) Все коды ответа, кроме 200, являются кодами ошибок. Каждый код ошибки означает ту или иную проблему, в таблице ниже смотрите описание возможных проблем.
Код ответаПотенциальная проблемаТекст ответа
200Проблем нетВ тексте ответа возвращается результат запроса.
400Неверно указаны параметры запроса.Проверьте параметры запроса на соответствие спецификации API.
401Не указан или указан неизвестный заголовок X-Api-Key. Пустой текст ответа. Не относится к справочникам.
404Фраза не найдена Соответствует ответу Wordstat “Нет подходящих запросов. Попробуйте изменить формулировку.” Возвращает стандартный формат ошибки (см. ниже)..
404Метод не найден Пустой текст ответа. Указана неверная конечная точка API.
422Неверно задан запрос Неверно указана проверяемая фраза - вордстат сам возвращает ошибку
Во всех случаях, когда возврат ошибки подразумевает возврат поясняющего сообщения – вам будет возвращена JSON-конструкция вида: ```json { "id": "fa18aecd-ac5c-443b-95a2-ef195949ecc7", "error_message": "NotFound", "instance": "/api/v1/region/check", "invalid_data": null } ``` Здесь: - **id** – уникальный идентификатор ошибки. Сообщите его вместе с сообщением об ошибке для облегчения сотрудникам техподдержки поиска конкретного случая возникновения ошибки. - **error\_message** – текстовое обозначение кода ошибки - **instance** – название конечной точки API, к которой было обращение, приведшее к ошибке - **invalid\_data** – массив строк, может содержать несколько строк, описывающих одну или несколько возникших ошибок. Nullable.