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)

PATCH

/api/listings/:slug

Обновление объявления (auth, owner)

DELETE

/api/listings/:id

Удаление объявления (auth, owner / admin)

GET

/api/categories

Дерево категорий с количеством объявлений

GET

/api/currency

Курсы валют (ЦБ РФ) в реальном времени

GET

/api/search

Полнотекстовый поиск по объявлениям и компаниям

GET

/api/companies

Список верифицированных компаний с фильтрами

GET

/api/users/:id

Публичный профиль пользователя/компании

GET

/api/market-data

Котировки сырьевых товаров по индустриям

GET

/api/news

Список новостей с пагинацией и фильтром по категории

POST

/api/chats

Создать чат / отправить сообщение (auth)

Пример ответа

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
}

Примеры curl

Получить объявления (Продажа зерно)

curl -G "https://rawmart.ru/api/listings" \
  -d "perPage=5" \
  -d "cat=agro" \
  -d "type=SELL" \
  -d "sortBy=price"

Полнотекстовый поиск

curl "https://rawmart.ru/api/listings?q=арматура+А500С&perPage=3"

Авторизованный запрос (создать объявление)

curl -X POST "https://rawmart.ru/api/listings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Пшеница 3 класс ГОСТ 52554",
    "type": "SELL",
    "categorySlug": "agro",
    "pricePerUnit": 15200,
    "currency": "RUB",
    "volumeUnit": "тонна",
    "country": "Россия"
  }'

Курсы валют

curl "https://rawmart.ru/api/currency"
# → { "USD": 89.5, "EUR": 97.2, "KZT": 0.21, ... }

Лимиты

Бесплатный: Нет доступа
Профи: 100 req/час
Корпоративный: 10 000 req/час

Получить API ключ

Доступен на корпоративном тарифе

Тарифы