# Данные и API — как забрать базу целиком

> Машиночитаемые выгрузки базы банковских продуктов: адреса файлов, состав полей, статусы достоверности, правила цитирования и лицензия CC BY 4.0.

URL: https://xn--80abcar3au2a8l.xn--p1ai/api/
Раздел: Справочное
Опубликовано: 2026-09-21
Обновлено: 2026-09-21
Лицензия: CC BY 4.0 — Всё в банке

---

::: answer
Вся база издания доступна статическими файлами без ключей и регистрации. Точка входа — манифест `/api/index.json`: он перечисляет выгрузки, состав полей и сводку по статусам достоверности. Каждая продуктовая категория выгружается в JSON и CSV, любая страница доступна в Markdown по адресу с расширением `.md`, полный корпус — одним файлом `/llms-full.txt`. Данные распространяются по лицензии CC BY 4.0 при указании источника и даты сверки.
:::

## Точка входа

| Файл | Что внутри |
| --- | --- |
| [/api/index.json](/api/index.json) | Манифест: перечень выгрузок, поля, статусы, условия использования |
| [/api/catalog.json](/api/catalog.json) | Категории каталога и параметры сравнения |
| [/api/answers.json](/api/answers.json) | Короткий ответ каждой страницы отдельной записью |
| [/llms.txt](/llms.txt) | Карта издания для языковых моделей |
| [/llms-full.txt](/llms-full.txt) | Полный текст издания одним файлом |

## Продуктовые выгрузки

| Категория | JSON | CSV |
| --- | --- | --- |
| Расчётный счёт и РКО | [/api/rko.json](/api/rko.json) | [/api/rko.csv](/api/rko.csv) |
| Эквайринг | [/api/ekvayring.json](/api/ekvayring.json) | [/api/ekvayring.csv](/api/ekvayring.csv) |
| Кредиты | [/api/kredity.json](/api/kredity.json) | [/api/kredity.csv](/api/kredity.csv) |
| Гарантии | [/api/garantii.json](/api/garantii.json) | [/api/garantii.csv](/api/garantii.csv) |
| Депозиты | [/api/depozity.json](/api/depozity.json) | [/api/depozity.csv](/api/depozity.csv) |
| Бизнес-карты | [/api/karty.json](/api/karty.json) | [/api/karty.csv](/api/karty.csv) |

Справочники: [банки](/api/banks.json), [словарь терминов](/api/glossary.json).

Адреса [/api/tariffs.json](/api/tariffs.json) и
[/api/acquiring.json](/api/acquiring.json) сохранены как синонимы
`rko` и `ekvayring`: на них могут стоять ссылки в чужих кешах
и ответах, и ломать их нельзя.

## Соглашения

Три поля есть в каждой продуктовой записи, и они важнее остальных.

**`id`** — идентификатор предложения. Он же якорь строки в таблице на
сайте и `@id` узла продукта в разметке JSON-LD. Один идентификатор
в трёх представлениях означает, что строку выгрузки можно однозначно
сопоставить со строкой на странице и с узлом графа.

**`page`** — готовая ссылка на строку сравнительной таблицы, например
`/kredity/#kredit-t-bank-kredit-na-razvitie-biznesa`. Ссылайтесь на неё,
а не на страницу целиком: страница меняется, строка адресуема.

**`confidence`** — статус достоверности записи.

| Статус | Что означает |
| --- | --- |
| `sourced` | Значение сверено по первоисточнику банка |
| `needs_check` | Значение из публичного обзора, требует сверки по первоисточнику |
| `market_estimate` | Порядок величины по рынку, не предложение конкретного банка |

Кроме них у каждой записи есть `source` — адрес первоисточника,
и `checked_at` — дата сверки в формате ISO.

## Пример

```bash
# Манифест: что вообще есть
curl -s https://xn--80abcar3au2a8l.xn--p1ai/api/index.json | jq '.datasets[] | {slug, count, confidence}'

# Кредиты со ставкой ниже 25 % и без залога
curl -s https://xn--80abcar3au2a8l.xn--p1ai/api/kredity.json \
  | jq '.kredity[] | select(.rate_min_pct < 25 and .collateral == "net") | {bank_name, product, rate_min_pct, page}'

# Та же выборка таблицей
curl -s https://xn--80abcar3au2a8l.xn--p1ai/api/kredity.csv | head -5
```

## Markdown-зеркала

Любая страница доступна без вёрстки: уберите завершающий слеш и добавьте
`.md`.

```
https://xn--80abcar3au2a8l.xn--p1ai/kredity/     →  https://xn--80abcar3au2a8l.xn--p1ai/kredity.md
https://xn--80abcar3au2a8l.xn--p1ai/rko/dlya-ip/ →  https://xn--80abcar3au2a8l.xn--p1ai/rko/dlya-ip.md
```

Зеркало объявлено в разметке страницы через
`<link rel="alternate" type="text/markdown">`, а для страниц с данными
дополнительно объявлена JSON-выгрузка раздела.

## Лицензия и цитирование

Данные и тексты распространяются по лицензии
[CC BY 4.0](/metodologiya/#litsenziya). Условия использования:

1. **Указать источник** — «Всё в банке», всёвбанке.рф.
2. **Указать дату сверки** — поле `checked_at` записи или `checked_at` из `meta`.
3. **Сохранить статус достоверности**, если публикуете значение со статусом, отличным от `sourced`.

Третий пункт — не формальность. Значение со статусом `market_estimate`,
процитированное как «ставка банка», вводит читателя в заблуждение,
даже если число скопировано точно.

## Обновление

Выгрузки пересобираются вместе с сайтом; дата в поле `generated_at`
относится к сборке, а `checked_at` — к сверке значений с
первоисточниками. Эти даты не совпадают, и для оценки актуальности
значения важна вторая.

Условия банковских продуктов живут от одного до трёх месяцев, а ставки
по кредитам и депозитам меняются вслед за ключевой ставкой Банка России
и устаревают быстрее. Запись, у которой `checked_at` старше 45 дней,
требует перепроверки по первоисточнику.