Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Taobao Сведения о товаре

POST

Состояние API

Состояние за 24 ч
100%
Среднее время за 24 ч
13.64 s
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Работает стабильно

Получите полную запись о товаре Taobao или Tmall: бренд, цены, остаток, все SKU, атрибуты, изображения, стоимость доставки и оценки магазина. Передайте числовой ID товара, ссылку на товар или текст «Поделиться» ровно с одной ссылкой на товар. Коды «Поделиться» без ссылки и устаревшие ссылки отклоняются.

Возможность «Сведения о товаре Taobao» возвращает полную публичную информацию об одном товаре Taobao или Tmall: название, бренд, цену и исходную цену, цену с купоном, наличие и число продаж, все SKU с собственными ценами и остатками, характеристики товара, главное изображение и изображения из подробного описания, а также магазин и стоимость доставки. Используйте её, чтобы детально разобрать карточку товара конкурента, отслеживать цены и акции, сравнивать предложения или наполнять каталог товаров.

url принимает числовой ID товара, ссылку на товар или текст из меню «Поделиться», содержащий ровно одну ссылку на товар. Отдельные коды «Поделиться» Taobao без ссылки и устаревшие ссылки отклоняются. Читая цены, учитывайте, что coupon_price появляется только при действующем купоне, а у каждого элемента skus может быть своя цена. is_tmall отличает магазины Tmall от обычных магазинов Taobao, у которых разные требования и гарантии.

Цена: $4.5 за 1 000 запросов ($0.0045 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Taobao Сведения о товаре (taobao/product_detail).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: taobao и action: product_detail, а параметры передайте в params.
- Обязательные параметры:
  - url: Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара.
- Возвращает один объект. Основные поля: id, url, title, brand (Бренд), price (Цена числом без символа валюты), original_price (Исходная (зачёркнутая) цена), currency, stock (Остаток), sold_count (Продано единиц), category_id (ID категории), location, is_tmall (Относится ли магазин к Tmall, а не к об…); всего полей: 77, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Пример тела запроса:
{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}
- Цена: $4.5 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаtaobaoИдентификатор платформы, фиксированное значение.
actionbodystringДаproduct_detailИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара. Ссылки e.tb.cn и m.tb.cn работают, только если их можно безопасно развернуть до страницы товара. Токены TaoPassword без ссылки, устаревшие ссылки и страницы, не относящиеся к товарам, отклоняются.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "taobao",
  "action": "product_detail",
  "params": {
    "url": "https://item.taobao.com/item.htm?id=744983869996"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "taobao",
  "action": "product_detail",
  "results": {
    "id": "•••",
    "url": "https://item.taobao.com/item.htm?id=744983869996",
    "title": "绿联转换插头英标韩国马来西亚澳洲新加坡新西兰Switch转换器充电",
    "price": 29.97,
    "currency": "CNY",
    "stock": 1397,
    "category_id": "50003472",
    "location": "廣東東莞",
    "is_tmall": true,
    "shop_name": "绿联数码旗舰店",
    "shop_id": "67095450",
    "skus": [
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Matte Black⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i3/713464357/O1CN01QOFAISCEu2L1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Outings] English to Chinese Converter|Lightweight White⭐Applicable to Hong Kong/Macau/Malaysia/Singapore, China",
        "price": 29.97,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01P9gIa5t80pC1chua_!!713464357.jpg"
      },
      {
        "id": "•••",
        "name": "[for Mainland China] Chinese to English Converter|Matte Black⭐Applicable to Hong Kong Version of Ps5/Switch2/Electrical Appliances in Hong Kong and Macau, China",
        "price": 30.17,
        "stock": 200,
        "image_url": "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01WLbh5e1i3YjKWsf7g_!!713464357.jpg"
      }
    ],
    "sku_count": 8,
    "main_image_url": "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
    "description_images": [
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN01tRpmSz1MdQI1WPZ8_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i1/713464357/O1CN019muBmB1i3YpL3L8sM_!!713464357.jpg",
      "https://img.alicdn.com/imgextra/i3/713464357/O1CN011J4LMz1i3Ynq3SQ1z_!!713464357.jpg"
    ],
    "price_usd": 5.27,
    "root_category_id": "50020579",
    "category_path": "首页 > 电子/电工 > 接线板/插头 > 转换插头",
    "min_order_quantity": 1,
    "images": [
      "https://img.alicdn.com/bao/uploaded/i4/713464357/O1CN01Cr4DMB1i3YoKXb4bM_!!4611686018427386405-0-item_pic.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01f4WmsN1i3YoKlcotr_!!713464357.jpg",
      "https://img.alicdn.com/bao/uploaded/i2/713464357/O1CN01KQ3NjW1i3YljOLkIv_!!713464357.jpg"
    ],
    "category_name": "转换插头",
    "description": "港版Switch转换插头 - 英标转中转换器,适用马来西亚插头与多国转换插头,具备65W快充功能。适合港版Switch 1与2使用,提供全球适用的转换解决方案。\n\n多国适用与高效快充功能 - 绿联多国转换插头支援英标、美标、德标与澳标等多种插头类型,适用全球多数国家与地区。内建65W快充技术,确保高功率需求的装置如Switch主机与笔电能快速充电,同时具备安全保护机制,避免过载与短路。\n\n多样款式与便利设计选择 - 转换插头提供多种款式选择,包含单独英转中、中转英与多合一组合。特别针对港版Switch 2使用者设计,提供适用进口电器的转换方案。轻巧便携设…",
    "keywords": [
      "港版Switch转换插头",
      "英标转中转换器",
      "适用马来西亚插头"
    ],
    "shop_score_description": 4.8,
    "shop_score_service": 4.8,
    "shop_score_delivery": 4.9,
    "free_shipping": false,
    "has_price_range": true,
    "payment_methods": [
      "蚂蚁花呗",
      "信用卡支付",
      "集分宝"
    ],
    "seller_id": "•••",
    "seller_credit_level": 20,
    "seller_type": "B",
    "seller_type_label": "Business seller",
    "selling_points": [
      "港版Switch2转换插头:专为港版Switch2设计转换插头,兼容多国电压,出国携带无烦恼。",
      "绿联品牌认证转换器:知名电子品牌绿联出品,通过多国安全认证,使用更安心。",
      "多国插头规格适用:适用马来西亚、新加坡、英国等多国插座标准,国际旅行首选。"
    ],
    "shop_logo_url": "https://img.alicdn.com/imgextra//d2/82/TB1rBsXkkL0gK0jSZFASuwA9pXa.jpg",
    "shop_url": "https://shop.m.taobao.com/shop/shop_index.htm?user_id=713464357",
    "shop_item_count": 1330,
    "shop_new_item_count": 28,
    "shop_opened_at": "2011-05-30 14:37:22",
    "seven_day_return": false,
    "reviews": [
      {
        "text": "还不错,通电了装换头会有提示灯 没送收纳袋。 体积挺小巧的。 手感挺细腻的。",
        "rating": 5,
        "posted_at": "2026.10.17 18:07",
        "sku": "颜色:【内地用】中转英转换器|轻骑白⭐港版PS5/Switch2/中国香港澳门地区电器适用",
        "author_avatar_url": "https://gw.alicdn.com/•••"
      }
    ],
    "platform": "taobao"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
brandБренд.
priceЦена числом без символа валюты; см. currency. В product_detail цены (включая price в каждой записи skus) в основном пересчитаны из долларов США и могут отличаться от цены на странице Taobao примерно на 1–4% в большую или меньшую сторону; ориентируйтесь на цену на странице.
original_priceИсходная (зачёркнутая) цена. В shop это единственная цена: зачёркнутое значение, которое показывает карточка товара, а не цена продажи, и оно может быть заметно выше неё; цену продажи получайте через product_detail.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
stockОстаток.
sold_countПродано единиц.
category_idID категории.
locationОписание местоположения передаётся как есть; формат зависит от платформы.
is_tmallОтносится ли магазин к Tmall, а не к обычным магазинам Taobao; для этих типов магазинов действуют разные требования к допуску продавцов и гарантии для покупателей.
shop_nameНазвание магазина.
shop_idID магазина.
shipping_feeСтоимость доставки.
ems_feeСтоимость доставки EMS.
express_feeСтоимость экспресс-доставки.
skusВсе варианты (SKU) карточки товара. Каждый элемент может содержать id, name, price, original_price, coupon_price, stock, props_ids и image_url; price в основном пересчитана из долларов США (см. price).
sku_countЧисло SKU.
spec_valuesПолная таблица значений вариантов, включая комбинации, которых нет в продаже; id идентифицирует значение, а text содержит его название.
props_imagesИзображения значений вариантов: id соответствует идентификатору в spec_values и props_ids, а image_url содержит URL изображения этого варианта.
attributesХарактеристики товара в виде записей {name, value}, например бренд, модель и место происхождения.
main_image_urlГлавное (первое) изображение.
description_imagesДлинные изображения из блока описания в порядке следования на странице.
description_htmlИсходный HTML блока описания, в основном теги изображений.
video_urlПрямая ссылка на видео в блоке главного изображения. Обычно это поле пустое, так как видео доступно редко; пустое значение не означает, что у товара нет видео.
coupon_priceЦена с учётом купона: ниже price, если купон применим; в остальных случаях поле отсутствует.
price_usdОриентировочная цена в долларах США, пересчитанная в возвращаемых данных.
total_priceИтоговая цена в возвращённых данных; часто отсутствует.
suggestive_priceРекомендованная розничная цена; часто отсутствует.
has_discountДействует ли скидка.
is_promotionУчаствует ли товар в акции.
promo_typeТип акции.
is_virtualЯвляется ли товар виртуальным (не физическим).
brand_idID бренда.
root_category_idID корневой категории.
category_pathПуть категорий (хлебные крошки).
weightВес товара в возвращённых данных; поле часто отсутствует или содержит 0.
sizeГабариты товара; часто отсутствуют.
favorite_countСколько раз товар добавили в избранное.
fans_countЧисло подписчиков в исходном виде; часто отсутствует.
min_order_quantityМинимальное количество для заказа.
shipping_toПримечание о зоне доставки; часто отсутствует.
listed_atВремя выставления на продажу (ISO 8601); поле отсутствует, если в данных его нет.
modified_atВремя последнего изменения (ISO 8601); поле отсутствует, если в данных его нет.
delist_atВремя снятия с продажи (ISO 8601); поле отсутствует, если в данных его нет.
imagesСсылки на изображения: в product_detail это фотографии товара, в reviews это фотографии покупателя (поле отсутствует, если в отзыве их нет).
category_nameНазвание конечной категории (product_detail).
descriptionКраткое содержание или описание, обычно короче text.
keywordsКлючевые слова со страницы товара (product_detail).
titleOriginalТрактуется так же, как на самой платформе
has_cn_titleТрактуется так же, как на самой платформе
shop_score_descriptionОценка магазина за соответствие товара описанию по 5-балльной шкале.
shop_score_serviceОценка магазина за обслуживание по 5-балльной шкале.
shop_score_deliveryОценка магазина за доставку по 5-балльной шкале.
free_shippingБесплатна ли доставка.
promotion_priceАкционная цена (product_detail; часто отсутствует).
discount_priceЦена со скидкой (product_detail; часто отсутствует).
discount_typeТип скидки или акции в исходной формулировке (например, флеш-распродажа).
price_noteПримечание к цене в исходном виде (product_detail).
has_price_rangeУказана ли цена диапазоном, потому что варианты стоят по-разному (product_detail).
payment_methodsПринимаемые способы оплаты (product_detail).
seller_idID продавца (в shop может отсутствовать).
seller_credit_levelУровень кредитного рейтинга продавца (число; чем выше, тем лучше).
seller_typeКод типа продавца (product_detail).
seller_type_labelНазвание типа продавца (product_detail), например Tmall или магазин компании.
selling_pointsТеги с преимуществами товара.
shop_logo_urlСсылка на логотип магазина (product_detail, shop; в shop может отсутствовать).
shop_urlСсылка на магазин (product_detail, shop).
shop_item_countЧисло товаров в продаже в магазине (product_detail, search, shop).
shop_new_item_countЧисло новых товаров в магазине (product_detail).
shop_opened_atДата открытия магазина в исходном виде (product_detail).
review_tagsТеги отзывов, у каждого есть tag (метка) и count (сколько раз упоминался; может отсутствовать).
review_countКоличество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0.
positive_rateДоля положительных отзывов о товаре (product_detail) в процентах; часто отсутствует.
seven_day_returnПоддерживается ли возврат без объяснения причин в течение семи дней (product_detail).
reviewsТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Что можно передать в url?

Числовой ID товара, ссылку на товар Taobao или Tmall либо текст из меню «Поделиться», содержащий ровно одну ссылку на товар. Короткие ссылки с e.tb.cn и m.tb.cn принимаются, только если они безопасно ведут на страницу товара. Отдельные коды «Поделиться», устаревшие ссылки и страницы магазинов или поиска отклоняются.

Как читать цены товаров с несколькими вариантами?

skus перечисляет все варианты, и у каждого могут быть своя цена, исходная цена, цена с купоном и остаток, а price — значение на уровне товара. При сравнении или мониторинге записывайте цены по каждому варианту. spec_values дополнительно содержит все значения вариантов, включая комбинации, которых нет в продаже.

Цены указаны в юанях? Есть ли цена в долларах США?

price, original_price и coupon_price — просто числа без символа валюты, поэтому смотрите валюту в currency, а не предполагайте её. price_usd — указанная в ответе справочная цена в долларах США; используйте её для приблизительного сравнения, а не как сумму к оплате. Цены в юанях в сведениях о товаре в основном пересчитаны из долларов США, поэтому могут отличаться от цены на странице Taobao примерно на 1–4% в большую или меньшую сторону. Ориентируйтесь на цену на странице.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Taobao: что такое ID товара и SKU ↗

    Taobao определяет ID товара как цифры после id= в ссылке на товар, а SKU — как конкретную комбинацию атрибутов, например цвета и размера. ID товара и SKU нельзя использовать взаимозаменяемо.

    Проверено 2026-09-04