# Tebiz Data

> Tebiz Data (api.tebiz.ru) - API с официальными данными для анализа рынков товаров и отраслей: объём и структура рынка, доли игроков, динамика по годам, цены и спрос по товарным кодам и регионам. Доступ через REST API для скриптов и через MCP для ИИ-агентов по одному ключу, подписка открывает все наборы каталога, цена фиксируется на оплаченный срок. Продукт Tebiz Group: маркетинговые исследования рынков с 2011 года.

Коротко:
- Платный доступ по подписке. Пробный доступ на 7 дней бесплатно и без карты, на образце данных каждого набора.
- Демо-ключ без регистрации есть в разделе «Быстрый старт»: https://api.tebiz.ru/guide#start. Он работает на образце данных.
- REST отдаёт JSON `{"data":[...],"next_cursor":...}`. MCP-инструмент `query` отдаёт колонки и строки отдельно: `{"columns":[...],"rows":[[...]],"has_more":...,"next_cursor":...}`.
- Фильтры только по полям с пометкой «фильтр» в справочнике набора, запись `?поле=оператор.значение`, операторы eq, ne, gt, gte, lt, lte, in, like, is_null. Сортировки нет, порядок строк задаёт курсор. До 1 000 строк за запрос.
- Каждая возвращённая строка списывается с месячного лимита строк тарифа. Остаток приходит в заголовках `X-Quota-*` и `X-RateLimit-*`.
- Агрегатов на сервере нет: итоги, доли и динамику считают на своей стороне по выгруженным строкам.
- Не сервис проверки контрагентов: данные предназначены для анализа рынков и отраслей.

Применение: объём, структура и динамика рынков, доли игроков и сравнение конкурентов, цены и спрос по товарным кодам и регионам, отраслевые исследования, данные для ИИ-агентов и аналитических моделей.

Для кого: аналитики и маркетологи, отделы стратегии и развития, консалтинговые и исследовательские агентства, инвестаналитики, производители и дистрибьюторы, разработчики аналитических систем и ИИ-агентов.

## Наборы данных
- [Бухгалтерская отчётность](https://api.tebiz.ru/data/financials): Бухгалтерский баланс и отчёт о финансовых результатах российских организаций по годам. По выручке и прибыли считают объём рынка, доли игроков и динамику отрасли. Источник: ФНС России. Охват: 2019-2025. Фильтры: `year` (отчётный год), `inn` (ИНН организации), `okved` (код ОКВЭД основного вида деятельности). Суммы в тыс. руб. REST: `GET https://api.tebiz.ru/v1/financials`. [Справочник полей](https://api.tebiz.ru/guide/financials.md)
- [Госзакупки (44-ФЗ)](https://api.tebiz.ru/data/zakupki): Позиции контрактов по 44-ФЗ: заказчики, поставщики, коды ОКПД2, цены, суммы и даты. По ним оценивают объём закупок по товарам, регионам и годам. Источник: ЕИС госзакупок (44-ФЗ). Охват: 2022-2025. Фильтры: `year` (отчётный год), `contract_id` (идентификатор контракта в реестре ЕИС), `notice_number` (номер извещения о закупке), `ikz` (идентификационный код закупки), `customer_inn` (ИНН заказчика), `region_code` (код региона заказчика), `supplier_inn` (ИНН поставщика), `object_code` (код ОКПД2 предмета закупки), `procurement_method` (способ определения поставщика), `budget_level` (уровень бюджета), `contract_date` (дата заключения контракта). Суммы в рублях. REST: `GET https://api.tebiz.ru/v1/zakupki`. [Справочник полей](https://api.tebiz.ru/guide/zakupki.md)
- Среднесписочная численность сотрудников: Среднесписочная численность сотрудников организаций за год. Выручка на работника, размер игроков отрасли. Только организации, без ИП. Готовится к запуску
- Уплаченные налоги и взносы по компаниям: Суммы, которые организация заплатила за год, по видам налогов, сборов и страховых взносов. Налоговая нагрузка отрасли. Без НДФЛ, уплаченного как налоговый агент, и без налогов при ввозе. Готовится к запуску

## Справочники
- [indicators](https://api.tebiz.ru/guide/indicators.md): Справочник строк бухгалтерской отчётности: код, название, тип и форма. Код не уникален: строка может встречаться несколько раз, например на начало и конец периода.

## Документация
- [Документация API](https://api.tebiz.ru/guide.md): ключ, фильтры, пагинация, лимиты, коды ошибок, MCP
- [OpenAPI 3.1](https://api.tebiz.ru/openapi.json): машиночитаемая схема REST с параметрами, ответами и ошибками
- [Подключение MCP](https://api.tebiz.ru/guide#mcp): готовые конфиги для Claude Code, Cursor, VS Code, Claude Desktop и Python MCP SDK
- [Полная документация одним файлом](https://api.tebiz.ru/llms-full.txt)
- [Примеры на Python и JavaScript](https://github.com/TG-info/tebiz-api-examples): запросы, пагинация, конфиг MCP

## Доступ
- [REST API](https://api.tebiz.ru/guide.md): `GET https://api.tebiz.ru/v1/<набор>`, ключ в заголовке `Authorization: Bearer tbz_live_...`
- [MCP-сервер](https://api.tebiz.ru/guide#mcp): адрес `https://api.tebiz.ru/mcp/`, транспорт Streamable HTTP, тот же ключ в заголовке `Authorization`, имя сервера `tebiz-data`. Инструменты `list_resources`, `describe_resource`, `query`, все только читают данные
- Веб-коннекторы ChatGPT и Claude.ai пока не подключатся: им нужен вход через OAuth, а сервер принимает ключ в заголовке
- [Ключ API](https://api.tebiz.ru/account): выпускается в личном кабинете после оформления подписки или пробного доступа

## Тарифы
- Пробный: 7 дней на срезе данных, бесплатно, без карты
- Старт: 100 тыс. строк в месяц, 60 запросов в минуту на ключ, 4 900 ₽ в месяц или 49 000 ₽ в год
- Про: 500 тыс. строк в месяц, 120 запросов в минуту на ключ, 7 900 ₽ в месяц или 79 000 ₽ в год
- Бизнес: 3 млн строк в месяц, 300 запросов в минуту на ключ, 24 900 ₽ в месяц или 249 000 ₽ в год
- Корпоративный: под задачу, 300 запросов в минуту на ключ, цена по запросу
- [Тарифы и оформление](https://api.tebiz.ru/#pricing): все наборы каталога в одной подписке, оформление и оплата в личном кабинете

## Optional
- [Публичная оферта](https://api.tebiz.ru/oferta)
- [Tebiz Group](https://tebiz.ru): маркетинговые исследования рынков с 2011 года, 7000+ рынков, 2500+ компаний-клиентов
- [Связаться](mailto:order@tebiz.ru): order@tebiz.ru, +7 (495) 159-70-79