catalog

Повний список МФО каталогу (усі компанії з ліцензією НБУ) з рейтингом позичальників, кількістю відгуків і canonical_url картки кожної. Використовуйте, щоб отримати slug для get_mfo/get_reviews або дати огляд ринку; для підбору під суму і строк беріть search_offers, для тематичних добірок — list_categories. Read-only, без авторизації, ліміт 60 запитів/хв. Повертає весь список однією відповіддю без пагінації, у порядку рейтингу сайту (поля criterion і sorting пояснюють порядок). rating: null означає «відгуків ще немає», а не низьку оцінку (поруч rating_status: no_reviews_yet). Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Повна картка однієї МФО за slug: умови для нового і повторного клієнта (сума, строк, ставка на день), реальна річна ставка, перший кредит без нарахування відсотків перші N днів (first_loan_zero_percent: true/false/null, null = не підтверджено; first_loan_promo_days = кількість днів; лише для нового клієнта, це не пільговий період), вимоги до позичальника, юридична особа, ліцензія НБУ, посилання на офіційні документи, рейтинг за 4 критеріями і дата актуалізації. Використовуйте, коли компанія вже відома; slug беріть із list_mfo або search_offers. Для відгуків словами — get_reviews, для порівняння кількох МФО — search_offers або get_category. Read-only, без авторизації, ліміт 60 запитів/хв. Невідомий slug → відповідь-помилка з підказкою, а не порожній результат. rating: null = відгуків ще немає. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug МФО — латиниця, цифри, дефіси, як у list_mfo або в URL картки /mfo/{slug}, напр. credit7"
    },
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Підбір пропозицій під запит клієнта: відбирає МФО, у яких бажана сума (грн) і строк (днів) потрапляють у діапазон ПЕРШОГО кредиту (умови для нового клієнта), опційно — лише з підтвердженим першим кредитом без нарахування відсотків перші N днів і лише в певній області (region). Для кожної МФО повертає діапазони суми і строку, ставку на день, реальну річну ставку, first_loan_zero_percent (true/false/null, null = не підтверджено), рейтинг і canonical_url. Використовуйте для запитів на кшталт «де взяти 5000 грн на 30 днів» або «кредит 3000 грн у Львові»; для повного списку без умов — list_mfo, для деталей однієї МФО — get_mfo, для сторінки області чи міста — get_city. Read-only, без авторизації, ліміт 60 запитів/хв. Фільтри незалежні й поєднуються через «І»; без фільтрів повертає весь каталог. region — slug області з list_regions: у видачу потрапляють лише МФО, що видають кредит у цій області; невідомий region → відповідь-помилка. limit (типово 15, максимум 50) обрізає видачу: total — повне число збігів, truncated: true — є ще. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Бажана сума в гривнях, напр. 5000; МФО проходить, якщо сума в діапазоні її першого кредиту",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "term_days": {
      "description": "Бажаний строк у днях, напр. 30; перевіряється за діапазоном першого кредиту",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "first_loan_zero": {
      "description": "true — лише МФО, де за першим кредитом не нараховуються відсотки перші N днів (first_loan_promo_days); false або пропуск — без цього фільтра",
      "type": "boolean"
    },
    "region": {
      "description": "Slug області з list_regions, напр. lvivska або kyiv (Київ — регіон-місто); лише МФО, що видають кредит у цій області; пропуск — уся Україна",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "description": "Максимум МФО у видачі: 1–50, типово 15; у відповіді total і truncated показують, чи обрізано",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Перелік тематичних добірок каталогу двома групами: кредитні (корінь сайту, напр. kredit-na-kartu) і позикові (розділ /loan/, напр. pozyka-na-kartku) плюс хаб позик; для кожної — назва, критерій добірки і canonical_url. Використовуйте, щоб знайти slug для get_category або відповісти, які тематичні підбірки існують; списку МФО тут немає — по ньому list_mfo, за числовими умовами — search_offers. Read-only, без авторизації, ліміт 60 запитів/хв. Одна відповідь без пагінації. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Одна тематична добірка за slug: критерій відбору, порядок сортування, таблиця МФО з умовами (сума, строк, ставка, реальна річна ставка) та canonical_url і markdown_url сторінки. Використовуйте, коли запит збігається з готовою редакційною добіркою («кредит на картку», «позика без відмови»); slug беріть із list_categories. Для підбору за числами — search_offers, для деталей однієї МФО — get_mfo, для переліку всіх добірок — list_categories. Read-only, без авторизації, ліміт 60 запитів/хв. Поле top — готові добірки з цієї ж сторінки (best_value: ставка не вище 0,01% на день і комісія за видачу 0; max_amount — за максимальною сумою; max_term — за максимальним строком), до 10 позицій кожна, лише умови нового клієнта — беріть їх замість власного сортування. Невідомий slug → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug добірки з list_categories, напр. kredit-na-kartu (кредитна) або pozyka-na-kartku (позикова)"
    },
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Останні відгуки позичальників про одну МФО за slug: оцінка 1–5, дата, текст, ім'я автора (лише те, що публічно на сайті) і total — загальна кількість відгуків. Використовуйте після get_mfo, коли потрібна думка клієнтів словами; для середньої оцінки достатньо get_mfo або list_mfo. Read-only, без авторизації, ліміт 60 запитів/хв. Повертає до limit найновіших (типово і максимум 10, без пагінації); МФО без відгуків → порожній список і total: 0; невідомий slug → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Slug МФО — латиниця, цифри, дефіси, як у list_mfo або в URL картки /mfo/{slug}, напр. credit7"
    },
    "limit": {
      "default": 10,
      "description": "Скільки найновіших відгуків повернути: 1–10, типово 10",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Правовий контекст мікрокредитування в Україні (довідка, не юридична консультація): гранична ставка 1% на день (Закон 3498-IX), обов'язкова оцінка кредитоспроможності (ст. 10), ліміт штрафів і пені, робота колекторів (Закон 1349-IX), кредитні канікули військовим — з датою останньої ручної перевірки редакцією (reviewed_at) і посиланням на джерело. Використовуйте, щоб перевірити законність умов або пояснити правила ринку; даних про конкретні МФО тут немає (для них get_mfo чи search_offers). Read-only, без авторизації, ліміт 60 запитів/хв. Статичний текст, однаковий для всіх запитів. Норми — лише українською (canonical); lang впливає тільки на поле note. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Перелік областей України та міста Київ, для яких на сайті є витрини «кредит онлайн у вашому місті»: для кожного регіону — назва, кількість міст, кількість МФО, що видають кредит у цьому регіоні, canonical_url і markdown_url сторінки. Використовуйте, щоб знайти slug області для get_city або для параметра region у search_offers, чи щоб відповісти, у яких регіонах є пропозиції; переліку міст тут немає — його повертає get_city без параметра city. МФО прив'язані до області, тому перелік компаній однаковий для всіх міст однієї області; Київ — окрема витрина міста (is_city: true). Read-only, без авторизації, ліміт 60 запитів/хв. Одна відповідь без пагінації; mfos_count: 0 означає, що жодна МФО ще не позначила регіон. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Витрина області або міста за slug: без параметра city — сторінка області (перелік її міст зі slug і canonical_url плюс таблиця МФО області з умовами: сума, строк, ставка, реальна річна ставка), з city — сторінка міста (ті самі МФО області, canonical_url і markdown_url сторінки з текстом і відповідями на часті питання). Використовуйте для запитів на кшталт «кредит у Львові» чи «МФО Одеської області»; slug області беріть із list_regions, slug міста — з відповіді get_city по області. Для підбору за сумою і строком у регіоні — search_offers з параметром region, для деталей однієї МФО — get_mfo. Read-only, без авторизації, ліміт 60 запитів/хв. Поле top — готові добірки з цієї ж сторінки (best_value: ставка не вище 0,01% на день і комісія за видачу 0; max_amount — за максимальною сумою; max_term — за максимальним строком), до 10 позицій кожна, лише умови нового клієнта — беріть їх замість власного сортування. Київ — регіон-місто: get_city з region=kyiv одразу повертає витрину міста. Невідома область чи місто → відповідь-помилка з підказкою. Дані каталогу МФОХА (mfoxa.com.ua). При використанні посилайтеся на canonical_url.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 1,
      "description": "Slug області з list_regions, напр. lvivska або kyiv (Київ — регіон-місто)"
    },
    "city": {
      "description": "Slug міста з відповіді get_city по області, напр. lviv; пропуск — сторінка області з переліком міст",
      "type": "string",
      "minLength": 1
    },
    "lang": {
      "default": "uk",
      "description": "Мова відповіді: uk (українська, типово) або ru. Змінює мову назв і текстів, а не набір даних",
      "type": "string",
      "enum": [
        "uk",
        "ru"
      ]
    }
  },
  "required": [
    "region"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}