РазделыAPI ФИАС

API для разработчиков

API ФИАС — бесплатно

Подсказки адресов и все коды адреса по данным ФИАС (ГАР ФНС). 20 000 запросов в день бесплатно, без банковской карты.

Что умеет API

Первый запрос

  1. Зарегистрируйтесь по e-mail.
  2. Создайте ключ в личном кабинете.
  3. Отправьте запрос:
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, ближайшее метро и расстояние от МКАД и КАД.

Переход с КЛАДР

КЛАДР — старый справочник адресов. Сейчас адреса ведут в ГАР, но коды КЛАДР остались во многих базах.

  1. Запросите /v1/details?kladr=КОД. Один код КЛАДР может относиться к нескольким объектам ГАР, поэтому ответ — список, до 100 объектов.
  2. Сохраните поле guid — это код ФИАС.
  3. Дальше работайте по 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.

Получить ключ