catalog

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

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Сколько МФО вернуть, от 1 до 100. По умолчанию 50. Поле total в ответе всегда содержит общее число МФО в каталоге.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Идентификатор МФО в каталоге, латиницей, как в адресе https://alexcredit.kz/mfo/{slug}, например «kviku». Берите из ответов list_mfo, search_offers или get_category, не угадывайте."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Подбор МФО под запрос заёмщика по сумме, сроку и признаку «первый микрокредит под 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.

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Желаемая сумма микрокредита в тенге (₸), целое число не меньше 1, например 100000. Без параметра сумма не фильтруется.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "term_days": {
      "description": "Желаемый срок в календарных днях, целое число не меньше 1, например 30. Без параметра срок не фильтруется.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "first_loan_zero": {
      "description": "true — оставить только МФО с подтверждённым первым микрокредитом под 0,01% (есть льготные дни или нулевая ставка для новых клиентов). false или отсутствие — не фильтровать по этому признаку.",
      "type": "boolean"
    },
    "limit": {
      "description": "Максимум предложений в ответе, от 1 до 100. По умолчанию 15. Если в ответе truncated = true, повторите запрос с большим limit.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

{
  "type": "object",
  "properties": {}
}

Одна тематическая подборка каталога по 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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug подборки, латиницей, как в адресе https://alexcredit.kz/{slug}, например «zaim-na-kartu». Берите из ответа list_categories, не угадывайте."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug МФО, как в get_mfo (например «kviku»). Берите из ответов list_mfo, search_offers или get_category."
    },
    "limit": {
      "description": "Сколько последних отзывов вернуть, от 1 до 50. По умолчанию 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

{
  "type": "object",
  "properties": {}
}