# Земеля API

> REST API данных о недвижимости в России по кадастровому номеру: земельные участки, объекты капитального строительства (здания, жилые и нежилые помещения, машино-места, сооружения) и торги по земельным участкам с torgi.gov.ru. Ответы в JSON, авторизация — Bearer-токен, базовый URL https://service.zemelyabot.ru.

Земеля (zemelyabot.ru) — сервис проверки земельных участков. API отдаёт те же данные, что и отчёты сервиса, для встраивания в CRM, ERP, маркетплейсы, банковский скоринг и сайты. Источники — ЕГРН/НСПД, ФГИС ТП, ФГИС ЛК, ГИС ОГД регионов, ГИС Торги, объявления Avito и ЦИАН, реестр сделок, судебные акты, OpenStreetMap.

Три продукта на одном токене:

- **Данные об участке** — `POST /cn_data` по кадастровому номеру или координатам точки: характеристики ЕГРН, границы GeoJSON, ЗОУИТ, территориальная зона ПЗЗ, лесфонд, ООПТ, права и обременения, рыночные цены (объявления, сделки, аналитика за сотку), окружение, соседние участки, документы градпланирования, рельеф, суды и нормативные акты. Набор полей задаётся при подключении токена. Для больших объёмов — очередь `POST /cn_data/jobs`.
- **Объекты капстроительства** — `POST /oks_data`: карточка ЕГРН, здание помещения, участок под объектом с долей, права и обременения, рыночная оценка за м², торги, суды, окружение дома. Квота общая с `/cn_data`.
- **Торги по земле** — `GET /torgi/lots`, `/torgi/lots/{id}`, `/torgi/stats`, `/torgi/changes`: база торгов по земельным участкам с 2024 года (аукционы по ЗК РФ; извещения о предоставлении участков без аукциона (ст. 39.18 ЗК) с отслеживанием, ушёл ли участок на аукцион; итоги и история), поиск по региону, номеру, кварталу, статусу и датам, синхронизация по изменениям. Подключается отдельно. Платно доступна полная выгрузка всей базы торгов одним файлом с ежедневными файлами изменений — по запросу на sales@zemelyabot.ru.

Демо-номера без списания квоты: `23:49:0000000:8273` для `/cn_data`, `16:50:011101:9999` для `/oks_data`. Тестовый ключ — бесплатно, по заявке на https://zemelyabot.ru/zemelya-api/#form.

## Документация

- [Полная документация (Markdown)](https://zemelyabot.ru/llms-full.txt): все эндпоинты, параметры запросов, поля ответов с примерами, коды ошибок
- [Документация (HTML)](https://zemelyabot.ru/api-docs/): та же документация на сайте
- [Начало работы](https://zemelyabot.ru/api-docs/#start): базовый URL, авторизация, примеры cURL, rate limit
- [POST /cn_data](https://zemelyabot.ru/api-docs/#cn_data): запрос по участку, кэш `use_cache`, поля ответа
- [POST /oks_data](https://zemelyabot.ru/api-docs/#oks_data): объекты капстроительства
- [API торгов](https://zemelyabot.ru/api-docs/#torgi): поиск лотов, статистика, изменения
- [Коды ошибок](https://zemelyabot.ru/api-docs/#errors): формат `{"error": "<код>", "message": "<текст>"}`

## О продукте

- [Земеля API](https://zemelyabot.ru/zemelya-api/): продукты, сценарии использования, подбор полей под задачу, заявка на тестовый ключ
- [Демо-стенд](https://service.zemelyabot.ru/demo): живой ответ API в виде отчёта и сырого JSON
- [Земельные торги](https://service.zemelyabot.ru/deals): торги по участкам на карте с ценой за сотку и итогами аукционов; кабинет с фильтрами для токенов с доступом к торгам

## Optional

- [Сервис Земеля](https://zemelyabot.ru/): проверка участков для частных пользователей, тарифы
- Контакты: sales@zemelyabot.ru