B BHAPI
Войти
1688REST API · v2

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

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

Протестировать бесплатно Документация

30 успешных вызовов · 30 дней с первого API-ключа этого парсера. Без карты · один раз для каждого парсера.

  1. 1. Регистрация
  2. 2. Ключ выбранного парсера
  3. 3. Первый API-запрос

От ссылки к карточке товара

URL товараJSON

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

Для сравнения товаров по показателям периода смотрите отдельный сервис: расширенная аналитика 1688 →

Выберите метод

Для карточки используйте ссылку или item_id. Описание товара доступно отдельным запросом.

Товар по ссылкеПередайте URL карточки 1688.POST /1688/api/v2/item/detail-by-url Товар по IDИспользуйте сохранённый item_id.POST /1688/api/v2/item/detail Описание товараПолучите изображения и блоки описания.POST /1688/api/v2/item/desc

Отзывы, магазины, каталог и поиск описаны в полном списке маршрутов v2.

Передайте ссылку или ID

Отправьте JSON на выбранный endpoint. Укажите API-токен с доступом к парсеру 1688 в заголовке X-API-Token.

cURL · карточка по ссылке
curl -X POST "https://bhapi.ru/1688/api/v2/item/detail-by-url" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: YOUR_API_TOKEN" \
  -d '{
    "url": "https://detail.1688.com/offer/652702302959.html",
    "language": "ru"
  }'

Для запроса по ID передайте целочисленный item_id в /1688/api/v2/item/detail. Параметры языка и режима запроса смотрите в документации.

Используйте ответ

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

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

В формате v2 полезные данные находятся внутри data.data; служебный status и data.code помогают отличить результат от ошибки. Это описание структуры, а не гарантия успешного запроса.

Отсутствующее значение или null не означает нулевую цену или отсутствие вариантов. Проверяйте наличие полей перед использованием.

Формат ответа и ошибки v2 →

Как работает бесплатный тест?

Free включает 30 успешных вызовов на 30 дней с первого API-ключа этого парсера. Регистрация сама по себе не запускает тестовый период. Без карты; бесплатный тест доступен одному пользователю один раз для каждого парсера. Новый ключ не обновляет лимит и не перезапускает период.

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

Протестировать бесплатно

Нужна не только интеграция с API?

Можно заказать бот, отчёт, админку или рабочий интерфейс вокруг этих данных.

Обсудить автоматизацию