Всё, что вам нужно знать о работе с API Росреестра — от получения кадастрового номера по адресу до выгрузки полной выписки ЕГРН в формате JSON или PDF. Статья актуальна на апрель 2026 года.

Содержание

1. Что такое API Росреестра и зачем оно нужно
2. Базовые принципы работы
3. Авторизация и безопасность
4. Основные эндпоинты и примеры запросов
5. Расшифровка ошибок
6. Ограничения и квоты
7. Готовые примеры кода на Python
8. FAQ и типовые проблемы

Что такое API Росреестра и зачем оно нужно

API Росреестра — это RESTful-интерфейс, через который можно программно:

• Найти объект недвижимости по адресу или кадастровому номеру;
• Получить выписку ЕГРН в форматах JSON, PDF или XML;
• Проверить переход/обременения прав;
• Отправлять «пакетные» запросы на 100+ объектов одним вызовом.

Интеграция подходит для:

• ИТ-отделов банков и ипотечных брокеров;
• Сервисов по подбору недвижимости;
• Программ бухгалтерского учёта и CRM-систем.

Базовые принципы работы

2.1 Формат взаимодействия

Все запросы выполняются по протоколу HTTPS, метод POST или GET, кодировка UTF-8.

2.2 Базовый URL

https://rosreestr.gov.ru/api/online/

2.3 Обязательные заголовки

• Authorization: Bearer <API_KEY>
• Content-Type: application/json

Авторизация и безопасность

1. Создайте аккаунт на официальном портале.
2. Сгенерируйте API Key в личном кабинете.
   ⚠️ Сразу сохраните ключ: при повторном открытии он показывается в зашифрованном виде.
3. Задайте имя ключа, чтобы отличать от других проектов.
4. Ограничьте IP (опционально) для повышения безопасности.

Основные эндпоинты и примеры запросов

4.1 Поиск кадастрового номера по адресу

POST /api/online/fir_objects_by_address
{
 "address": "г Москва, ул Льва Толстого, д 16",
 "limit": 10
}

Возвращает массив объектов, максимум 100 записей.

4.2 Получение краткой информации об объекте

GET /api/online/fir_object/{cadastralNumber}
Пример: /api/online/fir_object/77:01:0004010:123

4.3 Заказ полной выписки ЕГРН

POST /api/online/order_report
{
 "objectIds": ["77:01:0004010:123"],
 "reportType": "EGRN_FULL",
 "format": "PDF"
}

В ответе приходит orderId, по которому нужно опрашивать статус:

GET /api/online/order_status/{orderId}

4.4 Пакетная отправка (batch)

POST /api/online/batch_order
{
 "requests": [
 {"cadastralNumber": "47:14:901004:1818", "reportType": "EGRN_SHORT"},
 {"cadastralNumber": "77:05:0004010:321", "reportType": "OWNERSHIP_HISTORY"}
 ]
}

Ограничение: до 100 объектов в одном запросе.

Расшифровка ошибок

Ограничения и квоты

• RPS: 5 запросов в секунду на один API Key;
• Дневной лимит: 10 000 запросов;
• Максимальный размер пакета: 100 объектов;
• Время хранения готового отчёта: 72 часа.

Готовые примеры кода на Python

7.1 Установка зависимостей

pip install requests

7.2 Класс-обёртка

<code>
import requests, time

class RosreestrAPI:
 BASE = "https://rosreestr.gov.ru/api/online"
 def __init__(self, api_key):
 self.headers = {
 "Authorization": f"Bearer {api_key}",
 "Content-Type": "application/json"
 }

 def get_by_address(self, address):
 url = f"{self.BASE}/fir_objects_by_address"
 payload = {"address": address, "limit": 5}
 r = requests.post(url, json=payload, headers=self.headers)
 r.raise_for_status
 return r.json

 def wait_report(self, order_id, timeout=300):
 url = f"{self.BASE}/order_status/{order_id}"
 for _ in range(timeout//5):
 r = requests.get(url, headers=self.headers)
 j = r.json
 if j.get("status") == "DONE":
 return j["reportUrl"]
 time.sleep(5)
 raise TimeoutError("Report not ready")

api = RosreestrAPI("ВАШ_API_KEY")

data = api.get_by_address("г Казань, ул Пушкина, д 1")
print(data)
</code>

FAQ и типовые проблемы

Контакты поддержки:

• Телефон: ###-###-####
• Email: api@rosreestr.ru
• Telegram-канал: @rosreestr_api

Обновлено . В случае изменений в документации всегда сверяйтесь с официальным мануалом.