kz.alexcredit/catalog

Одна тематическая подборка каталога по slug. Возвращает title, canonical_url, criterion (признак попадания МФО), sorting (по позиции в каталоге, задаётся редакцией сайта), total, top и offers. Поле top: три готовых топа по условиям для нового клиента, те же, что показаны таблицами на странице: best_value (МФО с льготным периодом первого микрокредита под 0,01% в день, по убыванию льготных дней), max_amount (по максимальной сумме), max_term (по максимальному сроку), до 10 строк в каждом с rank, slug, суммой, сроком, ставкой и canonical_url; берите их вместо собственной сортировки. offers: для каждой МФО name, slug, диапазоны суммы и срока, ставка, rating_average и canonical_url карточки. Если подборки с таким slug нет, ответ помечен isError с текстом «Не найдено». Используйте, когда вопрос совпадает с готовой подборкой (например, микрокредиты пенсионерам); подбор под конкретную сумму и срок — search_offers, полная карточка МФО — get_mfo.

Правовой контекст микрокредитов в Казахстане на дату последней редакционной проверки: регулятор АРРФР и лицензирование, предельная ГЭСВ 46% годовых, особый режим коротких микрокредитов (до 45 МРП и 45 дней: не выше 0,3% в день, ГЭСВ до 179%), МРП текущего года, добровольный отказ от кредитов через eGov, признаки нелегальных кредиторов. Параметров нет. Возвращает country, reviewed_at (дата проверки — сверяйте актуальность), summary (краткий абзац), details_markdown (подробные факты) и source. Используйте для вопросов о законности ставок, лимитах и защите заёмщика; данные конкретной МФО — get_mfo.

Полная карточка одной МФО по slug. Возвращает условия для новых и повторных клиентов (сумма, срок, ставка, ГЭСВ), сводку (диапазоны, льготные дни, first_loan_zero_percent: true/false/null, где null = не подтверждено, время решения, работа 24/7), требования к заёмщику, комиссии, рейтинг по 4 критериям с числом отзывов, юридические данные (юрлицо, БИН, номер лицензии АРРФР и legal.license_registry_url — прямая ссылка на запись организации в реестре лицензий регулятора, первоисточник для проверки легальности) и дату актуализации записи. Если slug не существует, ответ помечен isError с текстом «Не найдено». Отзывы — через get_reviews. При использовании данных ссылайтесь на canonical_url.

Последние отзывы заёмщиков об одной МФО по slug — только публичные отзывы, опубликованные на сайте. Возвращает mfo_slug, canonical_url карточки, total (сколько отзывов всего) и reviews от новых к старым: author, rating (оценка от 1 до 5), date, text. Если отзывов ещё нет, reviews пустой и total равен 0 — это не низкая оценка. Если slug не существует, ответ помечен isError с текстом «Не найдено». Используйте для вопросов о репутации и опыте клиентов; сводный рейтинг и условия — get_mfo.

Все тематические подборки (витрины) каталога, сгруппированные по секциям: популярные, по способу получения, по сумме и сроку, по категориям заёмщиков и прочие. Параметров нет. Возвращает sections[], в каждой categories: title, slug, criterion (фактический признак отбора МФО в подборку, без обещаний одобрения) и canonical_url страницы. Используйте, чтобы найти slug подборки для get_category или предложить пользователю страницу под его ситуацию (например, микрокредит с плохой кредитной историей); фильтрация по конкретной сумме и сроку — search_offers.

Список всех МФО каталога AlexCredit (Казахстан) с рейтингом заёмщиков. Возвращает total и массив mfos, отсортированный по позиции в рейтинге (при равенстве — по средней оценке): name, slug, rating_position, rating_average (поле отсутствует, если отзывов ещё нет — это не низкая оценка), rating_count, диапазоны суммы и срока, ставка и canonical_url карточки. Используйте для обзора рынка и получения slug; условия конкретной МФО — get_mfo, подбор по сумме и сроку — search_offers. При использовании данных ссылайтесь на canonical_url.

Подбор МФО под запрос заёмщика по сумме, сроку и признаку «первый микрокредит под 0,01%». Фильтрует условия для новых клиентов: МФО попадает в ответ, если запрошенные сумма и срок входят в её диапазоны; без фильтров возвращает весь каталог. Порядок — по позиции в рейтинге. Возвращает query, total (сколько МФО подошло всего), truncated (true, если вернули не всех — увеличьте limit) и offers: name, slug, диапазоны суммы и срока, ставка, interest_free_days, first_loan_zero_percent (true/false/null, null = не подтверждено), rating_average, canonical_url. Пустой offers при total 0 означает, что под фильтры никто не подошёл — ослабьте сумму или срок. Используйте для вопросов «где взять N тенге на M дней»; готовые тематические подборки — get_category, карточка одной МФО — get_mfo. Условия волатильны, финальные — на canonical_url.