B BHAPI
Войти
TaobaoREST API · JSON

Парсер Taobao (Таобао): карточки товаров через API

Парсер Taobao (Таобао) получает карточку товара по ID или ссылке: название, цены, изображения, характеристики, магазин и варианты SKU в JSON. Отдельный API-метод возвращает изображения описания по ID товара.

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

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

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

Для запросов нужен API-токен с доступом к парсеру Taobao и подходящий тариф.

От параметра к данным товара

ID или URL товараJSON

GET /taobao/api/v1/item/detail-by-id

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

Получайте карточку по ID или ссылке. Изображения описания доступны отдельным методом.

Карточка по IDGET /taobao/api/v1/item/detail-by-idЧисловой item_id в строке запроса. Карточка по ссылкеPOST /taobao/api/v1/item/detail-by-urlТоварная HTTPS-ссылка в JSON-поле url. Изображения описанияGET /taobao/api/v1/item/description-by-iditem_id в строке запроса; ID и ссылки на изображения в ответе.

Отправьте запрос

Создайте токен для Taobao в кабинете BHAPI и передайте его в заголовке X-API-Token. В примере указан условный ID товара.

cURL · замените токен и параметр товара
curl "https://bhapi.ru/taobao/api/v1/item/detail-by-id?item_id=123456789" \
  -H "X-API-Token: YOUR_API_TOKEN"

Примеры для ссылки и описания, ошибки и правила учёта запросов приведены в полной документации.

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

Успешный ответ содержит status: "ok" и объект data. Проверяйте наличие значений перед использованием.

Карточка и цены
item_id, product_url, title, валюта, price_info и основные изображения main_imgs. Цены передаются строками; отсутствующее значение может быть null.
Характеристики и варианты
Категория category_id, характеристики product_props, свойства вариантов sku_props и список skus с ценами, остатком и ID свойств.
Магазин и описание
В карточке доступны shop_info и review_info, если сведения присутствуют. Метод описания возвращает item_id и массив detail_imgs.

Состав карточки зависит от товара: необязательные значения могут быть null, массивы — пустыми. Поля и типы перечислены в схеме карточки и схеме описания.

Схема JSON, параметры и примеры кода →

Вопросы о Taobao API

Можно ли запросить товар по ссылке?
Да. Используйте detail-by-url с полной HTTPS-ссылкой на товар. Поддерживаемые домены и проверка URL описаны в документации метода.
Что возвращает метод описания?
Только item_id и detail_imgs. Если изображений нет, массив может быть пустым. HTML описания в публичный ответ не включается.
Как получить доступ и узнать лимиты?
Проверьте доступ токена к Taobao и подходящий тариф в кабинете. Правила лимитов и учёта запросов собраны в документации.

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

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

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

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