Кэшбэк Гид

MCC API

БесплатноБез регистрации

Публичный REST API для получения MCC-кодов банковских категорий. 63+ кодов с описаниями, категориями и примерами магазинов. CORS разрешён — работает из браузера напрямую.

Base URL: https://cashbackguide.ru/api/mcc

Быстрый старт

Никаких ключей, никакой регистрации. Просто сделайте GET-запрос:

bash
# Найти 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

Эндпоинты

GET/api/mccСписок MCC-кодов с фильтрацией

Query параметры

ПараметрТипОбязательныйОписание
qstringнетПоиск по коду (5411), описанию или названию магазина (Пятёрочка)
categorystringнетФильтр по categoryId (groceries, fuel, restaurants и др.)

Без параметров — возвращает все 63 кодов.

Схема ответа

json
{
  "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

javascript
// Найти категорию магазина по коду или названию
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

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

bash
# Все 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/embed/kalkulatoriframe-версия без навигации
html
<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 встроена

📱

Адаптивный

Работает на мобильных устройствах