API для разработчиков
API ФИАС — бесплатно
Подсказки адресов и все коды адреса по данным ФИАС (ГАР ФНС). 20 000 запросов в день бесплатно, без банковской карты.
Что умеет API
- Подсказки при вводе — от региона до квартиры.
- Все данные адреса по коду — по коду ФИАС, id или коду КЛАДР.
- Адрес по координатам.
- В каждом ответе: индекс, ОКТМО, ОКАТО, ИФНС, кадастровый номер, координаты, метро и МКАД. Все поля.
Первый запрос
- Зарегистрируйтесь по e-mail.
- Создайте ключ в личном кабинете.
- Отправьте запрос:
curl
curl -G https://api.adresnitsa.ru/v1/search \ -H "Authorization: Token ВАШ_КЛЮЧ" \ --data-urlencode "q=москва сухонская 11" \ -d count=3
JavaScript
const url = new URL("https://api.adresnitsa.ru/v1/search"); url.search = new URLSearchParams({ q: "москва сухонская 11", count: "3" }); const res = await fetch(url, { headers: { Authorization: "Token ВАШ_КЛЮЧ" }, }); const data = await res.json();
Python
import requests
res = requests.get(
"https://api.adresnitsa.ru/v1/search",
params={"q": "москва сухонская 11", "count": 3},
headers={"Authorization": "Token ВАШ_КЛЮЧ"},
timeout=5,
)
data = res.json()PHP
<?php $url = "https://api.adresnitsa.ru/v1/search?" . http_build_query([ "q" => "москва сухонская 11", "count" => 3, ]); $ctx = stream_context_create(["http" => [ "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n", "ignore_errors" => true, ]]); $data = json_decode(file_get_contents($url, false, $ctx), true);
ГАР и ФИАС
ГАР — Государственный адресный реестр. Его ведёт ФНС России в системе ФИАС, поэтому код ФИАС — это GUID объекта в ГАР. Мы загружаем полную выгрузку ГАР каждую неделю.
- Все уровни адреса: регион, район, город, улица, дом, квартира.
- Документы о присвоении и изменении адреса, прежние названия улиц и городов.
- Сверх ГАР: координаты из OpenStreetMap, ближайшее метро и расстояние от МКАД и КАД.
Переход с КЛАДР
КЛАДР — старый справочник адресов. Сейчас адреса ведут в ГАР, но коды КЛАДР остались во многих базах.
- Запросите
/v1/details?kladr=КОД. Один код КЛАДР может относиться к нескольким объектам ГАР, поэтому ответ — список, до 100 объектов. - Сохраните поле
guid— это код ФИАС. - Дальше работайте по
guid. Код КЛАДР по-прежнему приходит в полеkladr.
curl
curl -G https://api.adresnitsa.ru/v1/details \ -H "Authorization: Token ВАШ_КЛЮЧ" \ -d kladr=77000000000283600
JavaScript
const url = new URL("https://api.adresnitsa.ru/v1/details"); url.search = new URLSearchParams({ kladr: "77000000000283600" }); const res = await fetch(url, { headers: { Authorization: "Token ВАШ_КЛЮЧ" }, }); const data = await res.json();
Python
import requests
res = requests.get(
"https://api.adresnitsa.ru/v1/details",
params={"kladr": "77000000000283600"},
headers={"Authorization": "Token ВАШ_КЛЮЧ"},
timeout=5,
)
data = res.json()PHP
<?php $url = "https://api.adresnitsa.ru/v1/details?" . http_build_query([ "kladr" => "77000000000283600", ]); $ctx = stream_context_create(["http" => [ "header" => "Authorization: Token ВАШ_КЛЮЧ\r\n", "ignore_errors" => true, ]]); $data = json_decode(file_get_contents($url, false, $ctx), true);
Уже есть подсказки адресов?
Совместимый режим понимает самый распространённый формат подсказок адресов: меняются только адрес сервера и ключ. Как перейти.
Попробовать без кода
Код ФИАС, ОКТМО и ИФНС по адресу и Адрес по координатам — посмотрите, что вернёт API.