API для разработчиков

Интегрируйте данные Kramba в свой интернет-магазин или сервис. Бесплатный REST API, JSON, без сложной авторизации.

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

Базовый URL: https://kramba.by/api/v1

GET https://kramba.by/api/v1?r=listings&limit=10
GET https://kramba.by/api/v1?r=listings&category=auto&city=minsk

Эндпоинты

GET /api/v1?r=listings

Получить список объявлений. Параметры: category, city, limit (макс. 50), min_price, max_price.

{
  "ok": true,
  "count": 10,
  "listings": [
    { "id": 123, "title": "iPhone 13", "price": 1200,
      "currency": "BYN", "city": "Минск",
      "url": "https://kramba.by/lot/iphone-13" }
  ]
}

GET /api/v1?r=prices&category=auto

Медианные, минимальные и максимальные цены б/у по категории.

POST /api/v1?r=scam_check

Проверить текст объявления на признаки мошенничества (Радар скама). Тело: {"text": "..."}.

Для магазинов (по ключу X-API-Key)

Ключ создаётся в кабинете магазина. Передавайте его в заголовке X-API-Key. Поле external_id — это ваш SKU из 1С/учётной системы для сопоставления товаров.

POST /api/v1?r=my/listing/create

Создать товар. Тело: {"title","price","city","condition","category_id","external_id"}.

POST /api/v1?r=my/listing/sync

Автосинхронизация остатков. Пришлите список SKU в наличии — товары с заданным external_id, которых нет в списке, автоматически помечаются проданными и скрываются из каталога. Тело: {"in_stock": ["SKU1","SKU2"], "reactivate": false}. Ответ: {hidden, restored}.

GET /api/v1?r=my/orders

Заказы (сделки) магазина: статус, сумма, трек-номер.

Примеры кода

PHP

$json = file_get_contents('https://kramba.by/api/v1?r=listings&category=auto&limit=5');
$data = json_decode($json, true);
foreach ($data['listings'] as $l) {
    echo $l['title'] . ' — ' . $l['price'] . " BYN\n";
}

Python

import requests
r = requests.get('https://kramba.by/api/v1', params={'r':'listings','limit':5})
for item in r.json()['listings']:
    print(item['title'], item['price'])

JavaScript

fetch('https://kramba.by/api/v1?r=listings&limit=5')
  .then(r => r.json())
  .then(d => d.listings.forEach(l => console.log(l.title, l.price)));

Для чего используют

• Интернет-магазины — показывать рыночные цены б/у рядом с новыми товарами
• Блоги и медиа — встраивать актуальные предложения по теме
• Сервисы оценки — использовать наши данные о ценах
• Антифрод-системы — проверять объявления через Радар скама

Нужен расширенный доступ или коммерческая интеграция?

Связаться