MCC API
БесплатноБез регистрацииПубличный REST API для получения MCC-кодов банковских категорий. 63+ кодов с описаниями, категориями и примерами магазинов. CORS разрешён — работает из браузера напрямую.
Быстрый старт
Никаких ключей, никакой регистрации. Просто сделайте GET-запрос:
# Найти MCC-код 5411 (супермаркеты)
curl "https://cashbackguide.ru/api/mcc?q=5411"
# Поиск по названию магазина
curl "https://cashbackguide.ru/api/mcc?q=Пятёрочка"
# Все коды категории АЗС
curl "https://cashbackguide.ru/api/mcc?category=fuel"Попробовать прямо здесь
GET https://cashbackguide.ru/api/mcc?q=5411
Нажмите «Запрос» чтобы попробовать API
Эндпоинты
/api/mccСписок MCC-кодов с фильтрациейQuery параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | нет | Поиск по коду (5411), описанию или названию магазина (Пятёрочка) |
| category | string | нет | Фильтр по categoryId (groceries, fuel, restaurants и др.) |
Без параметров — возвращает все 63 кодов.
Схема ответа
{
"total": 3,
"data": [
{
"code": "5411",
"description": "Супермаркеты, продуктовые магазины",
"categoryId": "groceries",
"merchants": ["Пятёрочка", "Магнит", "Перекрёсток", "Лента"]
},
{
"code": "5422",
"description": "Мясные магазины, мясники",
"categoryId": "groceries"
}
],
"source": "cashbackguide.ru",
"docs": "https://cashbackguide.ru/mcc"
}Категории (categoryId)
| categoryId | Название | Пример запроса |
|---|---|---|
| groceries | Супермаркеты | /api/mcc?category=groceries |
| restaurants | Рестораны | /api/mcc?category=restaurants |
| fastfood | Фастфуд | /api/mcc?category=fastfood |
| coffee | Кофейни | /api/mcc?category=coffee |
| fuel | АЗС | /api/mcc?category=fuel |
| taxi | Такси | /api/mcc?category=taxi |
| transport | Транспорт | /api/mcc?category=transport |
| pharmacy | Аптеки | /api/mcc?category=pharmacy |
| marketplace | Маркетплейсы | /api/mcc?category=marketplace |
| travel | Путешествия | /api/mcc?category=travel |
| entertainment | Развлечения | /api/mcc?category=entertainment |
| auto | Авто | /api/mcc?category=auto |
Примеры кода
JavaScript / TypeScript
// Найти категорию магазина по коду или названию
async function getMccInfo(query) {
const res = await fetch(
`https://cashbackguide.ru/api/mcc?q=${encodeURIComponent(query)}`
);
const { data } = await res.json();
return data[0] ?? null;
}
// Пример: определить категорию МСС 5814
const mcc = await getMccInfo('5814');
console.log(mcc.categoryId); // "fastfood"
console.log(mcc.description); // "Фастфуд"
// Получить все коды категории "marketplace"
const res = await fetch('https://cashbackguide.ru/api/mcc?category=marketplace');
const { data, total } = await res.json();
console.log(`Найдено кодов: ${total}`);Python
import requests
BASE = "https://cashbackguide.ru/api/mcc"
# Поиск по коду
def get_mcc(code: str) -> dict | None:
r = requests.get(BASE, params={"q": code})
r.raise_for_status()
data = r.json()["data"]
return data[0] if data else None
# Все коды категории
def get_category(category_id: str) -> list[dict]:
r = requests.get(BASE, params={"category": category_id})
r.raise_for_status()
return r.json()["data"]
# Примеры
mcc = get_mcc("5411")
print(mcc["categoryId"]) # "groceries"
fuel_codes = get_category("fuel")
print([m["code"] for m in fuel_codes]) # ['5541', '5542', ...]cURL
# Все MCC-коды
curl https://cashbackguide.ru/api/mcc | jq .total
# Поиск по коду
curl "https://cashbackguide.ru/api/mcc?q=5814" | jq '.data[0]'
# Поиск по магазину
curl "https://cashbackguide.ru/api/mcc?q=KFC" | jq '.data[].code'
# Все коды категории такси
curl "https://cashbackguide.ru/api/mcc?category=taxi" | jq '[.data[].code]'Технические детали
Аутентификация
Не требуется
Никаких API-ключей и токенов
CORS
Access-Control-Allow-Origin: *
Работает из браузера напрямую
Кэширование
Cache-Control: s-maxage=86400
CDN кэш на 24 часа
Формат
JSON
Content-Type: application/json
Для чего используют
- Финтех-приложения — определение категории транзакции для начисления кэшбэка
- Банковские приложения — автоматическое определение категории расходов
- Аналитика расходов — категоризация истории транзакций
- Telegram-боты — ответ на вопрос «почему не начислился кэшбэк»
- Учёт личных финансов — классификация покупок по категориям
О данных
База содержит 63 MCC-кодов с описаниями на русском языке, маппингом на категории кэшбэка и примерами магазинов. Данные обновляются при изменении базы Кэшбэк Гид. Для работы с визуальным справочником MCC-кодов используйте поиск по MCC-кодам →
Виджет калькулятора кэшбэка
Бесплатный интерактивный калькулятор для встраивания на свой сайт или блог. Пользователь вводит свои расходы — калькулятор показывает, сколько он теряет в месяц из-за неправильных карт. Всё работает на стороне браузера, данные не сохраняются.
/embed/kalkulatoriframe-версия без навигации<iframe
src="https://cashbackguide.ru/embed/kalkulator"
width="100%"
height="620"
frameborder="0"
style="border-radius:12px;border:1px solid #e5e7eb;"
title="Калькулятор кэшбэка — Кэшбэк Гид"
></iframe>Бесплатно
Без ограничений, навсегда
Attribution
Ссылка на CashbackGuide.ru встроена
Адаптивный
Работает на мобильных устройствах