API для разработчиков
REST API v1 · Base URL: https://rawmart.ru/api
Аутентификация
API использует Bearer токены. Получите API ключ в настройках аккаунта (тариф Корпоративный).
# Заголовок запроса
Authorization: Bearer YOUR_API_KEY
Эндпоинты
GET
/api/listings
Список объявлений с фильтрацией и пагинацией
GET
/api/listings/:slug
Детали объявления по slug
POST
/api/listings
Создание нового объявления (auth)
GET
/api/categories
Дерево категорий с количеством объявлений
GET
/api/currency
Курсы валют (ЦБ РФ) в реальном времени
GET
/api/search
Полнотекстовый поиск по объявлениям
GET
/api/users/:id
Публичный профиль пользователя/компании
Пример ответа
GET /api/listings?perPage=2
{
"data": [{
"id": "clx123abc",
"title": "Пшеница 3 класс, ГОСТ 52554",
"type": "SELL",
"pricePerUnit": 15200,
"currency": "RUB",
"volumeUnit": "тонна",
"country": "Россия",
"region": "Краснодарский край"
}],
"total": 1842,
"page": 1,
"totalPages": 922
}Лимиты
- Бесплатный
- Нет доступа
- Профи
- 100 req/час
- Корпоративный
- 10 000 req/час