Номер детали на входе — карточка, аналоги, применяемость по автомобилям, фото и цены рынка на выходе. Подключается к сайту, 1С, CRM или боту за один вечер.
https://kulisabase.ru/api/v1$ curl "https://kulisabase.ru/api/v1/lookup?q=0451103316&brand=BOSCH" \ -H "Authorization: Bearer ВАШ_ТОКЕН" { "ok": true, "items": [{ "brand": "Bosch", "number": "0451103316", "name": "Фильтр масляный ДВС …", "country": "Германия", "crosses": "3568", "appl": "1817", "market": { "min": 438, "offers": 1 }, "photos": ["https://kulisabase.ru/img/b4df92….jpg", …] }] }
Цифры берутся из живой статистики базы и обновляются сами: сейчас 28 419 519 артикулов, 485 010 145 кроссов, 1 213 124 955 связок применяемости, 24 230 280 фото.
Мы держим базу и обновляем её каждый день. Вы получаете готовые ответы по API и строите на них свой продукт: поиск на сайте, проценку, карточки товаров, подбор по автомобилю.
Бренд, название, страна, технические атрибуты. Все бренды с этим номером — чтобы уточнить, какой нужен. /lookup /brands
Чем заменить деталь: до 200 аналогов с минимальной ценой и числом предложений. /analogs
На какие автомобили ставится: марка, модель, двигатель, годы. Подбор деталей по авто и расшифровка VIN. /applicability /bycar /vin
Ссылки на фото деталей по https с нашего сервера — можно сразу ставить в карточку товара. Поле photos
Минимальная цена и число предложений, живые предложения поставщиков со сроками, переоценка вашего прайса по правилам. /offers /reprice
Проценка до 500 позиций за вызов, выгрузка в xlsx, csv, json, 1С, МойСклад и YML-фид для маркетплейсов. /bulk /export
Один запрос — одна деталь. Метод /card стоит 2 запроса, списки — по числу позиций, справочники и мониторинг — бесплатно. Полная документация с примерами ответов и песочница — в личном кабинете после регистрации.
| Метод | Что возвращает | Стоимость |
|---|---|---|
| Деталь по номеру | ||
GET/lookup?q=&brand= | карточки по номеру: бренд, название, атрибуты, кроссы, применяемость, цена рынка, фото | 1 |
GET/card?q=&brand= | всё одним вызовом: карточки, аналоги, применяемость, предложения поставщиков | 2 |
GET/analogs?q= | аналоги и кроссы, до 200 | 1 |
GET/applicability?q= | автомобили: марка, модель, двигатель, годы, до 500 строк | 1 |
GET/offers?q= | предложения поставщиков: наличие, срок, склад, цены | 1 |
GET/brands?q= | бренды, у которых есть деталь с таким номером | 1 |
GET/search?q= | поиск по названию, до 40 строк | 1 |
| Списки и цены | ||
POST/bulk | проценка списком до 500 позиций | по позициям |
POST/reprice | ваша цена против рынка и новая цена по правилу: market, undercut, hold, margin | по позициям |
| Файлы и фиды | ||
GET/export?format=&list= | файл: xlsx, csv, json, 1c, yml, moysklad; можно с наценкой | по позициям |
GET/feed.yml?list= | YML-фид с фото для магазинов и маркетплейсов | по позициям |
| Подбор по автомобилю | ||
GET/vin?vin= | расшифровка VIN: модель и поколение по каталогу, детали под эту машину | 1 |
GET/bycar?make=&model=&year= | детали по марке, модели, году, двигателю, до 300 | 1 |
GET/makes · /models?make= | справочники марок и моделей | 0 |
| Аккаунт, мониторинг цен, вебхуки | ||
GET/me | тариф, лимит, остаток запросов | 0 |
GETPOST/watchlist | позиции на мониторинге цены / поставить новые | 0 |
DELETE/watchlist/:id | снять позицию с мониторинга | 0 |
POST/webhook/test | тестовое событие на ваш вебхук, подпись HMAC-SHA256 | 0 |
Отправляете номера — получаете по каждому найденные карточки, число кроссов и связок применяемости, фото, минимальную цену и число предложений. Ответ ниже — настоящий, сокращён до одной позиции.
curl -X POST "https://kulisabase.ru/api/v1/bulk" \
-H "Authorization: Bearer ВАШ_ТОКЕН" \
-H "Content-Type: application/json" \
-d '{"items":[{"brand":"BOSCH","number":"0451103316"},
{"number":"W81180"}]}'
import requests
r = requests.post(
"https://kulisabase.ru/api/v1/bulk",
headers={"Authorization": "Bearer ВАШ_ТОКЕН"},
json={"items": [{"brand": "BOSCH", "number": "0451103316"},
{"number": "W81180"}]},
)
for row in r.json()["results"]:
card = row["cards"][0]
print(card["brand"], card["number"], card["min_price"])
const r = await fetch("https://kulisabase.ru/api/v1/bulk", {
method: "POST",
headers: {
"Authorization": "Bearer ВАШ_ТОКЕН",
"Content-Type": "application/json",
},
body: JSON.stringify({ items: [
{ brand: "BOSCH", number: "0451103316" },
{ number: "W81180" },
] }),
});
const { results } = await r.json();
$ch = curl_init("https://kulisabase.ru/api/v1/bulk");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer ВАШ_ТОКЕН",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["items" => [
["brand" => "BOSCH", "number" => "0451103316"],
["number" => "W81180"],
]]),
]);
$data = json_decode(curl_exec($ch), true);
{
"ok": true,
"count": 2,
"results": [{
"input": "0451103316",
"brand": "BOSCH",
"found": 1,
"brand_match": true,
"cards": [{
"brand": "Bosch",
"number": "0451103316",
"name": "Фильтр масляный ДВС …",
"quality": 2,
"appl": 1817,
"crosses": 3568,
"imgs": 7,
"min_price": "438",
"offers": 1,
"price_offers_low": true
}]
}, …]
}
Поиск идёт по той же базе, что и API. Без регистрации — до 25 запросов в час.
Создайте аккаунт и подтвердите почту. Демо-доступ на 14 дней и 1 000 запросов включается сразу.
Токен лежит в кабинете на главной и в разделе «Документация». Передавайте его в заголовке Authorization: Bearer.
Любой метод можно выполнить прямо в кабинете и увидеть настоящий ответ, а потом перенести запрос в свой код.
Все методы доступны на всех тарифах. Отличается только число запросов в месяц. Оплата по счёту.
Один вызов по одной детали. /card стоит 2 запроса, потому что возвращает сразу карточку, аналоги, применяемость и предложения. В /bulk, /reprice, /export и /feed.yml списывается по числу позиций. /me, /makes, /models, мониторинг и вебхуки бесплатны.
API ответит кодом 429 и напишет, сколько осталось. Остаток всегда виден в GET /me и в кабинете. Тариф можно поменять в разделе «Баланс и тариф API».
JSON в UTF-8, в каждом ответе есть поле ok. Файлы выгрузок приходят с заголовком Content-Disposition. Ошибки: 400 — нет параметров, 401 — неверный токен, 403 — тариф без API, 429 — лимит, 502 — источник временно недоступен.
Да, параметром ?token=. Это удобно для ссылок на выгрузку в 1С и МойСклад, но в коде сервера лучше использовать заголовок.
Ссылки в поле photos ведут на наш сервер по https. Их можно ставить в карточки товаров и фиды.
Каждый день: добавляются артикулы, кроссы, применяемость, фото и цены. Цифры на этой странице берутся из живой статистики.
Регистрация занимает минуту, токен и 1 000 демо-запросов — сразу. Нужен большой объём или помощь с подключением — оставьте заявку.