↑ Все API

API: стандартизация адресов

✔️ Разбивает адрес по отдельным полям (регион, город, улица, дом, квартира).

✔️ Рассчитывает корректный индекс по данным Почты России.

✔️ Определяет координаты.

✔️ Показывает округ и район города, ближайшее метро, площадь и стоимость квартиры.

✔️ Достает коды КЛАДР, ФИАС (ГАР), ОКАТО, ОКТМО и ИФНС.

Только для России.

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

Пример запроса:

            
                POST https://cleaner.dadata.ru/api/v1/clean/address
            
            
[ "мск сухонска 11/-89" ]

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.
  • ${SECRET_KEY} — секретный ключ.

Тело запроса передавайте в кодировке UTF-8.

Что в ответе

Стандартизованный объект:

Пример ответа
[
{
    "source": "мск сухонска 11/-89",
    "result": "г Москва, ул Сухонская, д 11, кв 89",
    "postal_code": "127642",
    "country": "Россия",
    "country_iso_code": "RU",
    "federal_district": "Центральный",
    "region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
    "region_kladr_id": "7700000000000",
    "region_iso_code": "RU-MOW",
    "region_with_type": "г Москва",
    "region_type": "г",
    "region_type_full": "город",
    "region": "Москва",
    "area_fias_id": null,
    "area_kladr_id": null,
    "area_with_type": null,
    "area_type": null,
    "area_type_full": null,
    "area": null,
    "city_fias_id": null,
    "city_kladr_id": null,
    "city_with_type": null,
    "city_type": null,
    "city_type_full": null,
    "city": null,
    "city_area": "Северо-восточный",
    "city_district_fias_id": null,
    "city_district_kladr_id": null,
    "city_district_with_type": "р-н Северное Медведково",
    "city_district_type": "р-н",
    "city_district_type_full": "район",
    "city_district": "Северное Медведково",
    "settlement_fias_id": null,
    "settlement_kladr_id": null,
    "settlement_with_type": null,
    "settlement_type": null,
    "settlement_type_full": null,
    "settlement": null,
    "street_fias_id": "95dbf7fb-0dd4-4a04-8100-4f6c847564b5",
    "street_kladr_id": "77000000000283600",
    "street_with_type": "ул Сухонская",
    "street_type": "ул",
    "street_type_full": "улица",
    "street": "Сухонская",
    "stead_fias_id": null,
    "stead_kladr_id": null,
    "stead_cadnum": null,
    "stead_type": null,
    "stead_type_full": null,
    "stead": null,
    "house_fias_id": "5ee84ac0-eb9a-4b42-b814-2f5f7c27c255",
    "house_kladr_id": "7700000000028360004",
    "house_cadnum": "77:02:0004008:1017",
    "house_type": "д",
    "house_type_full": "дом",
    "house": "11",
    "block_type": null,
    "block_type_full": null,
    "block": null,
    "entrance": null,
    "floor": null,
    "flat_fias_id": "f26b876b-6857-4951-b060-ec6559f04a9a",
    "flat_cadnum": "77:02:0004008:4143",
    "flat_type": "кв",
    "flat_type_full": "квартира",
    "flat": "89",
    "flat_area": "34.6",
    "square_meter_price": "242314",
    "flat_price": "8384065",
    "postal_box": null,
    "fias_id": "f26b876b-6857-4951-b060-ec6559f04a9a",
    "fias_code": "77000000000000028360004",
    "fias_level": "9",
    "fias_actuality_state": "0",
    "kladr_id": "7700000000028360004",
    "capital_marker": "0",
    "okato": "45280583000",
    "oktmo": "45362000",
    "tax_office": "7715",
    "tax_office_legal": "7715",
    "timezone": "UTC+3",
    "geo_lat": "55.8782557",
    "geo_lon": "37.65372",
    "beltway_hit": "IN_MKAD",
    "beltway_distance": null,
    "qc_geo": 0,
    "qc_complete": 0,
    "qc_house": 2,
    "qc": 0,
    "unparsed_parts": null,
    "metro": [
        {
            "name": "Бабушкинская",
            "line": "Калужско-Рижская",
            "distance": 1.1
        },
        {
            "name": "Медведково",
            "line": "Калужско-Рижская",
            "distance": 1.2
        },
        {
            "name": "Свиблово",
            "line": "Калужско-Рижская",
            "distance": 2.5
        }
    ]
}
]
НазваниеДлинаОписание
source250Исходный адрес одной строкой
result500Стандартизованный адрес одной строкой
postal_code6Индекс
country120Страна
country_iso_code2ISO-код страны
federal_district20Федеральный округ
region_fias_id36ФИАС-код региона
region_kladr_id19КЛАДР-код региона
region_iso_code6ISO-код региона
region_with_type131Регион с типом
region_type10Тип региона (сокращенный)
region_type_full50Тип региона
region120Регион
area_fias_id36ФИАС-код района
area_kladr_id19КЛАДР-код района
area_with_type131Район в регионе с типом
area_type10Тип района в регионе (сокращенный)
area_type_full50Тип района в регионе
area120Район в регионе
city_fias_id36ФИАС-код города
city_kladr_id19КЛАДР-код города
city_with_type131Город с типом
city_type10Тип города (сокращенный)
city_type_full50Тип города
city120Город
city_area120Административный округ (только для Москвы)
city_district_fias_id36ФИАС-код района города (заполняется, только если район есть в ФИАС)
city_district_kladr_id19КЛАДР-код района города (не заполняется)
city_district_with_type131Район города с типом
city_district_type10Тип района города (сокращенный)
city_district_type_full50Тип района города
city_district120Район города
settlement_fias_id36ФИАС-код населенного пункта
settlement_kladr_id19КЛАДР-код населенного пункта
settlement_with_type131Населенный пункт с типом
settlement_type10Тип населенного пункта (сокращенный)
settlement_type_full50Тип населенного пункта
settlement120Населенный пункт
street_fias_id36ФИАС-код улицы
street_kladr_id19КЛАДР-код улицы
street_with_type131Улица с типом
street_type10Тип улицы (сокращенный)
street_type_full50Тип улицы
street120Улица
stead_fias_id36ФИАС-код земельного участка
stead_kladr_id19КЛАДР-код земельного участка
stead_cadnum50Кадастровый номер земельного участка
stead_type10= «уч»
stead_type_full50= «участок»
stead50Номер земельного участка
house_fias_id36ФИАС-код дома
house_kladr_id19КЛАДР-код дома
house_cadnum50Кадастровый номер дома
house_type10Тип дома (сокращенный)
house_type_full50Тип дома
house50Дом
block_type10Тип корпуса/строения (сокращенный)
block_type_full50Тип корпуса/строения
block50Корпус/строение
entrance10Подъезд
floor10Этаж
flat_fias_id36ФИАС-код квартиры
flat_cadnum50Кадастровый номер квартиры
flat_type10Тип квартиры (сокращенный)
flat_type_full50Тип квартиры
flat50Квартира
flat_area50Площадь квартиры
square_meter_price50Рыночная стоимость м²
flat_price50Рыночная стоимость квартиры
postal_box50Абонентский ящик
fias_id36ФИАС-код адреса (идентификатор ФИАС)
  ROOM.ROOMGUID — если квартира найдена в ФИАС
  HOUSE.HOUSEGUID — если дом найден в ФИАС
  ADDROBJ.AOGUID — в противном случае
fias_codeНе заполняется, используйте fias_id
fias_level2Уровень детализации, до которого адрес найден в ФИАС
  0 — страна
  1 — регион
  3 — район
  4 — город
  5 — район города
  6 — населенный пункт
  7 — улица
  8 — дом
  9 — квартира
  65 — планировочная структура
  90 — доп. территория
  91 — улица в доп. территории
  -1 — иностранный или пустой
fias_actuality_stateПризнак актуальности адреса в ФИАС
  0 — актуальный
  1-50 — переименован
  51 — переподчинен
  99 — удален
kladr_id19КЛАДР-код адреса
capital_marker1Признак центра района или региона
  1 — центр района
      (Московская обл, Одинцовский р-н, г Одинцово)
  2 — центр региона
      (Новосибирская обл, г Новосибирск)
  3 — центр района и региона
      (Томская обл, г Томск)
  4 — центральный район региона
      (Тюменская обл, Тюменский р-н)
  0 — ничего из перечисленного
      (Московская обл, г Балашиха)
okato11Код ОКАТО
oktmo11Код ОКТМО
tax_office4Код ИФНС для физических лиц
tax_office_legal4Код ИФНС для организаций
timezone50Часовой пояс города для России, часовой пояс страны — для иностранных адресов. Если у страны несколько поясов, вернёт минимальный и максимальный через слеш: UTC+5/UTC+6
geo_lat12Координаты: широта
geo_lon12Координаты: долгота
beltway_hit8Внутри кольцевой?
  IN_MKAD — внутри МКАД (Москва)
  OUT_MKAD — за МКАД (Москва и область)
  IN_KAD — внутри КАД (Санкт-Петербург)
  OUT_KAD — за КАД (Санкт-Петербург и область)
  пусто — в остальных случаях
beltway_distance3Расстояние от кольцевой в км. Заполнено, только если beltway_hit : OUT_MKAD или OUT_KAD, иначе пустое
qc_geo5Код точности координат
qc_complete5Код пригодности к рассылке
qc_house5Признак наличия дома в ФИАС
qc5Код проверки адреса
unparsed_parts250Нераспознанная часть адреса. Для адреса «Москва, Митинская улица, 40, вход с торца» вернет «ВХОД, С, ТОРЦА»
metroСписок ближайших станций метро (до трёх штук)

Координаты есть у 97% домов в Москве, 91% в Санкт-Петербурге, 69% в других городах-миллиониках и 47% по остальной России.

Площадь и стоимость есть у 70% квартир в России.

Коды качества

Код проверки qc

Нужно ли вручную проверить распознанный адрес:

Код qcОписаниеНужно проверить вручную?
0Адрес распознан уверенноНет
2Адрес пустой или заведомо «мусорный»Нет
1

Остались «лишние» части. Пример: «109341 Тверская область Москва Верхние Поля» — здесь лишняя «Тверская область».

Либо в исходном адресе недостаточно данных для уверенного разбора. Пример: «Сходня Красная 12» — здесь нет региона и города.

Да
3 Есть альтернативные варианты. Пример: «Москва Тверская-Ямская» — в Москве четыре Тверских-Ямских улицы. Да

Код пригодности к рассылке qc_complete

Годится ли адрес для доставки корреспонденции:

Код qc_completeПодходит для рассылки?Описание
0ДаПригоден для почтовой рассылки
10Под вопросомДома нет в ФИАС
5Под вопросомНет квартиры. Подходит для юридических лиц или частных владений
8Под вопросом До почтового отделения — абонентский ящик или адрес до востребования. Подходит для писем, но не для курьерской доставки.
9Под вопросомСначала проверьте, правильно ли Дадата разобрала исходный адрес
1НетНет региона
2НетНет города
3НетНет улицы
4НетНет дома
6НетАдрес неполный
7НетИностранный адрес

Признак наличия дома в ФИАС qc_house и код точности координат qc_geo

Уточняют вероятность успешной доставки письма:

Код qc_houseКод qc_geoВероятность доставкиОписание
2любойВысокаяДом найден в ФИАС
100ВысокаяДом не найден в ФИАС, но есть на картах
101СредняяДом не найден в ФИАС, но есть похожий на картах
10≥ 2НизкаяДом не найден в ФИАС и на картах

Код точности координат qc_geo

Точность координат адреса для курьерской доставки:

Код qc_geoОписание
0Точные координаты
1Ближайший дом
2Улица
3Населенный пункт
4Город
5Координаты не определены

Коды ответа на запрос

HTTP-код ответаОписание
200Запрос успешно обработан
400 Некорректный запрос
401 В запросе отсутствует API-ключ или секретный ключ
Или в запросе указан несуществующий ключ
403 Не подтверждена почта
Или недостаточно средств для обработки запроса, пополните баланс
405Запрос сделан с методом, отличным от POST
429Слишком много запросов в секунду или новых соединений в минуту
5xxПроизошла внутренняя ошибка сервиса

Примеры и интеграции

Ограничения

В запросе разрешено передавать только один адрес.

Максимальная частота запросов — 20 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Дадата не поддерживает вызов этого метода из браузерного JavaScript. Иначе злоумышленник мог бы похитить секретный ключ и использовать API за ваш счет.

Стоимость

15 копеек за запись