Обзор сервиса

BHAPI — портал API‑парсеров для маркетплейсов и каталогов. Портал объединяет несколько специализированных парсеров с общей системой авторизации, биллинга и квот.

{ }

Чистый JSON

Структурированный, типизированный ответ — без HTML, без скриптов, только данные.

⚡

Асинхронная обработка

Оптимизирован под высокую нагрузку с параллельным парсингом через Playwright.

📦

Полные данные

Цены, SKU, изображения и описания товаров, характеристики, продавец (в зависимости от парсера).

🔒

Безопасность

Аутентификация по API‑токену, CSRF‑защита, валидация URL и источников, rate limiting.

Для кого этот сервис? Дропшипперы, маркетплейс‑селлеры, аналитики e‑commerce и разработчики интеграций с маркетплейсами.

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

Три шага, чтобы получить данные первого товара через портал:

1

Зарегистрируйтесь

Создайте аккаунт на странице регистрации. Это бесплатно и занимает 30 секунд.

2

Получите API‑токен

В личном кабинете создайте API‑токен. Он будет показан один раз — сохраните его.

3

Сделайте первый запрос

Отправьте запрос к нужному парсеру (например, 1688 или WB) и получите структурированный JSON.

Пример: парсер 1688 (cURL)

curl -X POST "https://bhapi.ru/1688/api/v2/item/detail-by-url" \
  -H "X-API-Token: ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://detail.1688.com/offer/123456789.html","language":"ru"}'

Успешный ответ (пример для 1688, 200 OK)

{
  "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"`
`Безопасность`	Не передавайте токен в URL	Query string сохраняется в proxy/browser logs

Безопасность. Передавайте токен только через заголовок X-API-Token. Токены в URL могут попадать в логи прокси-серверов и не поддерживаются по умолчанию.

Где взять токен? Войдите в личный кабинет → Токены и нажмите «Создать токен». Полный токен показывается только один раз при создании — скопируйте и сохраните его.

Базовый URL

Все запросы к порталу отправляются на базовый URL:

https://bhapi.ru

Примеры полных URL эндпоинтов:

# Парсер 1688
POST https://bhapi.ru/1688/api/v2/item/detail-by-url

# Парсер Wildberries
POST https://bhapi.ru/wb/api/v1/search
Content-Type: application/json

{"query":"кроссовки","page":1}

Обзор парсеров портала

Сейчас доступны парсеры:

1688 — актуальные маршруты для карточек, магазинов, категорий и поиска 1688, префикс /1688/api/v2/…. Подробности: документация парсера 1688 →
Wildberries (WB) — парсер каталога Wildberries, префикс /wb/api/v1/…. Канонический поиск: POST /wb/api/v1/search; метаданные готовых категорий: GET /wb/api/v1/search/presets; динамические параметры: POST /wb/api/v1/search/filters. Подробности: документация парсера WB →
Amazon — парсер каталога Amazon, префикс /amazon/api/v1/…. Подробности: документация парсера Amazon →