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

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 GET "https://bhapi.ru/1688/api/v1/item/by-url?url=https://detail.1688.com/offer/123456789.html" \
  -H "X-API-Token: ВАШ_ТОКЕН"
Успешный ответ (пример для 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"
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

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

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