API Taobao Сведения о товаре
Состояние API
- Состояние за 24 ч
- 100%
- Среднее время за 24 ч
- 13.64 s
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите полную запись о товаре 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 время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | taobao | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | product_detail | Идентификатор возможности, фиксированное значение. |
url | body.params | string | Да | - | Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара. Ссылки e.tb.cn и m.tb.cn работают, только если их можно безопасно развернуть до страницы товара. Токены TaoPassword без ссылки, устаревшие ссылки и страницы, не относящиеся к товарам, отклоняются. |
Примеры кода
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 меняются при каждом вызове, поэтому показана только их структура.
{
"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_id | ID категории. |
location | Описание местоположения передаётся как есть; формат зависит от платформы. |
is_tmall | Относится ли магазин к Tmall, а не к обычным магазинам Taobao; для этих типов магазинов действуют разные требования к допуску продавцов и гарантии для покупателей. |
shop_name | Название магазина. |
shop_id | ID магазина. |
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_id | ID бренда. |
root_category_id | ID корневой категории. |
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_id | ID продавца (в 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