1688 REST API

API парсер 1688 для получения данных товаров

Подключайте данные карточек 1688 к своим сервисам: цены, SKU, изображения, характеристики, описание, магазин и расширенные детали товара в JSON.

Endpoint'ы для интеграции

Используйте v1 для базовых сценариев и v2 для расширенной структуры карточки.

Товар по ссылке

Передайте URL товара 1688 и получите структурированный ответ.

POST /1688/api/v1/item/by-url

Пакетная загрузка

Загрузите файл со ссылками, чтобы обработать несколько товаров одним запросом.

POST /1688/api/v1/item/by-file

Расширенная карточка

Получите детализированную структуру товара для аналитики и витрин.

POST /1688/api/v2/item/detail-by-url

Пример запроса
curl -X POST "https://bhapi.ru/1688/api/v1/item/by-url" \
  -H "X-API-Token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://detail.1688.com/offer/123456789.html"}'
Пример ответа
{
  "success": true,
  "item_id": "123456789",
  "title": "Название товара",
  "price": "25.80",
  "sku": [
    {"name": "color", "value": "black"}
  ]
}
Что возвращается

Название, изображения, цены, SKU-варианты, характеристики, упаковка, данные магазина, рейтинг и поля, доступные на странице товара.

Документация и доступ

Для работы нужен API-токен BHAPI. Подробные параметры запросов и ответы описаны в документации v1 и v2.