Обзор сервиса
BHAPI — портал API‑парсеров для маркетплейсов и каталогов. Портал объединяет несколько специализированных парсеров с общей системой авторизации, биллинга и квот.
Структурированный, типизированный ответ — без HTML, без скриптов, только данные.
Оптимизирован под высокую нагрузку с параллельным парсингом через Playwright.
Цены, SKU, изображения и описания товаров, характеристики, продавец (в зависимости от парсера).
Аутентификация по API‑токену, CSRF‑защита, валидация URL и источников, rate limiting.
Быстрый старт
Три шага, чтобы получить данные первого товара через портал:
Создайте аккаунт на странице регистрации. Это бесплатно и занимает 30 секунд.
В личном кабинете создайте API‑токен. Он будет показан один раз — сохраните его.
Отправьте запрос к нужному парсеру (например, 1688 или WB) и получите структурированный JSON.
curl -X GET "https://bhapi.ru/1688/api/v1/item/by-url?url=https://detail.1688.com/offer/123456789.html" \
-H "X-API-Token: ВАШ_ТОКЕН"
{
"code": 200,
"message": "OK",
"data": {
"item_id": "123456789",
"url": "https://detail.1688.com/offer/123456789.html",
"title": "Мужская демисезонная куртка из натуральной кожи",
"images": [
"https://cbu01.alicdn.com/img/...1.jpg",
"https://cbu01.alicdn.com/img/...2.jpg"
],
"price_info": {
"currency": "CNY",
"price": 198.0,
"tiers": [
{"from_qty": 1, "to_qty": 2, "price": 218.0},
{"from_qty": 3, "to_qty": 49, "price": 198.0},
{"from_qty": 50, "to_qty": null, "price": 178.0}
]
},
"skus": [...],
"shop": {"shop_id": "b2b-xxxx", "shop_name": "广州皮革厂"},
...
}
}
Аутентификация
Все запросы к API должны содержать ваш API-токен. Токен можно передать двумя способами:
| Способ | Формат | Пример |
|---|---|---|
Заголовок рекомендуется |
X-API-Token: ВАШ_ТОКЕН |
-H "X-API-Token: abc123xyz" |
Query-параметр |
?apiToken=ВАШ_ТОКЕН |
/api/v1/item/by-url?url=...&apiToken=abc123xyz |
X-API-Token,
а не через query-параметр. Query-параметры могут попадать в логи прокси-серверов.
Базовый URL
Все запросы к порталу отправляются на базовый URL:
https://bhapi.ru
Примеры полных URL эндпоинтов:
# Парсер 1688
GET https://bhapi.ru/1688/api/v1/item/by-url?url=https://detail.1688.com/offer/123456789.html
# Парсер Wildberries
GET https://bhapi.ru/wb/api/v1/search?q=кроссовки&page=1
Обзор парсеров портала
Сейчас доступны парсеры:
- 1688 — парсер товаров 1688.com, префикс
/1688/api/v1/…. Подробности: документация парсера 1688 → - Wildberries (WB) — парсер каталога Wildberries, префикс
/wb/api/v1/…. Подробности: документация парсера WB →