Data API — REST и MCP

Доступ по токену

Каждый запрос несёт токен в заголовке. Токен выдаётся после оформления подписки и показывается один раз — сохраните его.

Authorization: Bearer tbz_live_...

Токен привязан к набору грантов (какие наборы доступны) и к лимитам. Потеряли — обратитесь за перевыпуском.

REST API

База: https://api.tebiz.ru/v1/<набор>. Ответ — JSON {"data":[...],"next_cursor":...}.

Фильтры

Синтаксис ?колонка=оператор.значение, несколько фильтров — по И. Операторы: eq, ne, gt, gte, lt, lte, like, in, is_null. Доступность зависит от типа колонки (см. набор). in — список через запятую; like — * как шаблон; is_null — без значения.

curl -H "Authorization: Bearer tbz_live_..." \
  "https://api.tebiz.ru/v1/financials?limit=5&year=eq.VALUE&select=year,inn,name"

Выбор колонок и лимит

select=a,b,c — только эти колонки. limit=N — размер страницы (не больше максимума набора). Фильтров не более 50, список in — не более 1000 значений.

Пагинация курсором

Сортировки нет — порядок задаёт курсор. В ответе есть next_cursor; если он не null, повторите запрос с cursor=<значение> до null.

{
  "data": [ { "...": "..." } ],
  "next_cursor": "eyJ5ZWFyIjogMjAyNH0="   // null — последняя страница
}

Лимиты в заголовках

MCP — для AI-агентов

Эндпоинт https://api.tebiz.ru/mcp, транспорт Streamable HTTP, тот же Bearer-токен.

{
  "mcpServers": {
    "tebiz": {
      "url": "https://api.tebiz.ru/mcp",
      "headers": { "Authorization": "Bearer tbz_live_..." }
    }
  }
}

Наборы данных

Список из реестра — при добавлении набора обновляется автоматически. filter — можно фильтровать, cursor — ключ пагинации.

Быстрый переход: financialsindicators

Коды ошибок

Тело — JSON {"error":"...","detail":"..."}. В detail — что поправить.