catalog

Возвращает одну тематическую подборку (витрину) каталога по её slug (slug берите из list_categories): критерий попадания, порядок сортировки и полный список предложений МФО в ней. Slug может быть и витриной по сумме вида «zaim-10000-rubley» (страницы есть на каждую сумму от 1000 до 100000 рублей шагом 1000): тогда в подборке МФО, выдающие эту сумму новому клиенту, а top состоит из двух таблиц (best_value и max_term). Ответ: JSON {title, slug, canonical_url, criterion, sorting, total, top, offers[]}, у каждого предложения: name, slug, amount_range, term_range, rate, rating_average и canonical_url карточки МФО. top — три автотаблицы витрины (условия для нового клиента, до 10 строк каждая, note и дата updated): best_value — беспроцентный первый займ по убыванию дней без процентов, max_amount — по максимальной сумме, max_term — по максимальному сроку; те же таблицы показаны на странице подборки, берите их вместо собственной сортировки. Постраничной навигации нет — возвращаются все МФО подборки. Используйте, когда вопрос пользователя совпадает с темой подборки (займ на карту, без отказа, с плохой кредитной историей, пенсионерам и т.п.); подбор по конкретной сумме или сроку — search_offers, подробности по одной МФО — get_mfo. Несуществующий slug → ответ с isError и текстом «Не найдено». Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). При использовании данных ссылайтесь на canonical_url.

Возвращает справку по регулированию микрозаймов в России: предельная ставка 0,8% в день, лимит переплаты 100% по займам до года с 01.04.2026, законы 151-ФЗ и 353-ФЗ, самозапрет на кредиты, период охлаждения, права заёмщика при взыскании. Параметров нет. Ответ: JSON {country, reviewed_at (дата последней редакционной проверки правового блока), summary (краткий текст), details_markdown (полный блок в Markdown), source (URL первоисточника на zaimhub.com)}. Используйте для вопросов о законах, лимитах ставок и правах заёмщика; условия конкретных МФО — get_mfo, подбор предложений — search_offers. Правовые лимиты актуальны на reviewed_at. Только чтение, без авторизации и побочных эффектов и внешних сетевых вызовов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429).

Возвращает подробную карточку одной МФО по её slug (slug берите из list_mfo, search_offers или get_category). Ответ: JSON с полями name, slug, canonical_url, data_updated_at; summary (диапазоны суммы, срока, ставки и ПСК; first_loan_zero_percent: true/false/null, где null — «не подтверждено»; interest_free_days, decision_time_minutes, processing_24_7); conditions.new_client и conditions.repeat_client (сумма, срок, ставка, полная стоимость кредита); rating (average, reviews_count, position, criteria[] по 4 критериям); requirements (возраст, гражданство, документы, занятость, регистрация, доход); fees (комиссии и штрафы); legal (legal_entity, ogrn, cbr_registry_number, cbr_registry_url — прямая ссылка на запись организации в госреестре МФО Банка России, первоисточник для проверки легальности; legal_address, phone, email). Пустые поля не возвращаются. Используйте, когда нужны условия, требования или юрданные конкретной МФО; список нескольких МФО — list_mfo, отзывы клиентов — get_reviews, подбор по сумме и сроку — search_offers. Несуществующий slug → ответ с isError и текстом «Не найдено». Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). При использовании данных ссылайтесь на canonical_url.

Возвращает последние отзывы заёмщиков о конкретной МФО по её slug, от новых к старым. Параметр limit — сколько отзывов вернуть (по умолчанию 10, максимум 50); поле total — общее число отзывов на сайте, постраничной навигации нет. Ответ: JSON {mfo_slug, canonical_url, total, reviews[]}, у каждого отзыва: author, rating (1–5), date, text — только публичные данные сайта, без персональных. Используйте для мнений реальных клиентов и примеров их опыта; средняя оценка и место в рейтинге есть в get_mfo (поле rating), сравнение МФО по рейтингу — list_mfo. Несуществующий slug → ответ с isError и текстом «Не найдено». Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). При цитировании ссылайтесь на canonical_url.

Возвращает все тематические подборки (витрины) каталога ZaimHub, сгруппированные по разделам: популярные, по способу получения, по сумме и сроку, по категориям заёмщиков, другие. Параметров нет. Ответ: JSON {sections[]}, в каждой секции section (название раздела) и categories[] с полями title, slug, criterion (критерий попадания МФО в подборку) и canonical_url страницы. Используйте, чтобы найти подходящую подборку и её slug, например «займ на карту», «займ без отказа», «займы пенсионерам»; содержимое подборки с предложениями МФО возвращает get_category, подбор по числовым параметрам — search_offers. Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429).

Возвращает список всех МФО каталога ZaimHub (только организации из государственного реестра Банка России), отсортированный по месту в рейтинге заёмщиков. Параметр limit — сколько МФО вернуть (по умолчанию 50, максимум 100); поле total показывает общее число, постраничной навигации нет. Ответ: JSON {total, mfos[]}, у каждой МФО: name, slug, rating_position, rating_average (0–5), rating_count, текстовые диапазоны amount_range / term_range / rate и canonical_url карточки. Используйте для обзора каталога, сравнения МФО по рейтингу и получения slug; подробная карточка одной МФО — get_mfo, подбор по сумме и сроку — search_offers, тематические подборки — list_categories. Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). При использовании данных ссылайтесь на canonical_url.

Подбирает предложения МФО для новых клиентов по сумме займа (amount, ₽), сроку (term_days, дней) и признаку первого займа под 0% (first_loan_zero: true — только МФО с беспроцентным первым займом). Все фильтры необязательны; без них возвращается весь каталог, поэтому задавайте amount и/или term_days и ограничивайте limit (по умолчанию 15, максимум 100). Результат отсортирован по месту в рейтинге заёмщиков. Ответ: JSON {query, total, truncated, note, offers[]}, у каждого предложения: name, slug, amount_range, term_range, rate, interest_free_days, first_loan_zero_percent (true/false/null, null — не подтверждено), rating_average, canonical_url. Используйте, когда у пользователя есть конкретная сумма или срок; весь каталог по рейтингу — list_mfo, тематические подборки (займ на карту, без отказа и т.п.) — list_categories и get_category, подробности по МФО — get_mfo. Только чтение, без авторизации и побочных эффектов; лимит 60 запросов в минуту с одного IP (при превышении HTTP 429). Условия волатильны — финальные смотрите на canonical_url.