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

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

Точка входа#

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

Справочники: банки, словарь терминов.

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

Соглашения#

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

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

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

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

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

Пример#

# Манифест: что вообще есть
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. Условия использования:

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

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

Обновление#

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

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