Wiki API · v1.1

Документация

Получите доступ к каталогу из 24 000+ товаров через простой REST API. Запросы возвращают JSON, отвечают за 50–200 мс, не требуют сложной аутентификации.

curl https://api.onecatalog.ru/wiki/v1/products/?limit=1 \
  -H "X-API-Key: YOUR_KEY"

Прямо сейчас вы можете попробовать API с демо-ключом, который встроен в этот сайт. Полный быстрый старт →

С чего начать

🚀

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

Сделайте первый запрос за пять минут — с примерами на curl, JavaScript и Python.

📖

API Reference

Все 17 эндпоинтов с параметрами, форматом ответа и примерами для каждого.

⚙️

OpenAPI 3.1 ↗

Машиночитаемая спецификация. Сгенерируйте типизированный клиент для своего языка.

Возможности API

Фильтрация и поиск

Любые комбинации фильтров по бренду, типу, стране, категории. Полнотекстовый поиск по названию и артикулу.

Многоязычные данные

Названия и описания возвращаются как объект { ru, en }. Можно выбирать нужный язык на стороне клиента.

Стабильные идентификаторы

Каждый товар имеет public_id и slug — они не меняются при пересборе каталога.

Изображения трёх размеров

В ответе приходят URL для min, middle и max размеров — выбирайте подходящий.

Журнал изменений

15 марта 2026

NEWДобавлен эндпоинт /products/{id}/suppliers/ — теперь можно получать поставщиков товара одним запросом.

2 февраля 2026

IMPROVEDПоле menutitle во всех ответах теперь возвращается как объект { ru, en } вместо плоской строки.

14 января 2026

DEPRECATEDЧисловые id товаров в URL устарели — используйте public_id или slug. Старый формат продолжит работать до июля 2026.

Нужна помощь?

Напишите на hello@onecatalog.ru или в Telegram @onecatalog. Отвечаем в течение рабочего дня.