Доступность платформы
- Состояние за 24 ч
- 100%
За последние 30 дней
Доступные возможности
Все действия Taobao: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите карточки товаров на Taobao и Tmall по ключевому слову: цена и место отправки, а также число продаж, рейтинг, магазин и купоны или скидки, если они есть. | $13.5 за 1 000 запросов | Работает стабильно · состояние 98% |
Сведения о товареproduct_detail | Получите полную запись о товаре Taobao или Tmall: бренд, цены, остаток, все SKU, атрибуты, изображения, стоимость доставки и оценки магазина. | $4.5 за 1 000 запросов | Работает стабильно · состояние 100% |
Магазинshop | Получите до 20 товаров, которые продавец Taobao продаёт сейчас: зачёркнутую цену, категорию, флаг «доставка включена», основное изображение и оценки магазина. | $1.39 за 1 000 запросов | Работает стабильно · состояние 100% |
Отзывыreviews | Получите отзывы покупателей о товаре Taobao. | $1.39 за 1 000 запросов | Норма |
Вопросыquestions | Получите вопросы покупателей и ответы на странице товара Taobao с числом ответов и датой публикации каждого вопроса. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Taobao?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите карточки товаров на Taobao и Tmall по ключевому слову: цена и место отправки, а также число продаж, рейтинг, магазин и купоны или скидки, если они есть. Простой поиск по ключевому слову надёжнее всего и поддерживает пагинацию через | keyword | max_price, min_price, page, sort, tmall_only | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $13.5 за 1 000 запросов | id · url · title · price · currency · sold_count · rating · rating_scale · location · shop_name · image_url · stock · shop_id · sold_text · original_price · coupon_price · discount_type · is_tmall · brand · category_id · seller_credit_level · seller_positive_rate · shop_score_description · shop_score_service · shop_score_delivery · subtitle · search_rank · free_shipping · selling_points · review_tags · images · discount_rate · spu_id · category_path · review_count · latest_review · seller_type · shop_opened_at · shop_age_years · shop_item_count · shop_score_vs_industry · platform |
product_detailСведения о товаре Получите полную запись о товаре Taobao или Tmall: бренд, цены, остаток, все SKU, атрибуты, изображения, стоимость доставки и оценки магазина. Передайте числовой ID товара, ссылку на товар или текст «Поделиться» ровно с одной ссылкой на товар. Коды «Поделиться» без ссылки и устаревшие ссылки отклоняются. | url | — | Режим выдачи: Sync | — | $4.5 за 1 000 запросов | id · url · title · brand · price · original_price · currency · stock · sold_count · category_id · location · is_tmall · shop_name · shop_id · shipping_fee · ems_fee · express_fee · skus · sku_count · spec_values · props_images · attributes · main_image_url · description_images · description_html · video_url · coupon_price · price_usd · total_price · suggestive_price · has_discount · is_promotion · promo_type · is_virtual · brand_id · root_category_id · category_path · weight · size · favorite_count · fans_count · min_order_quantity · shipping_to · listed_at · modified_at · delist_at · images · category_name · description · keywords · titleOriginal · has_cn_title · shop_score_description · shop_score_service · shop_score_delivery · free_shipping · promotion_price · discount_price · discount_type · price_note · has_price_range · payment_methods · seller_id · seller_credit_level · seller_type · seller_type_label · selling_points · shop_logo_url · shop_url · shop_item_count · shop_new_item_count · shop_opened_at · review_tags · review_count · positive_rate · seven_day_return · reviews · platform |
shopМагазин Получите до 20 товаров, которые продавец Taobao продаёт сейчас: зачёркнутую цену, категорию, флаг «доставка включена», основное изображение и оценки магазина. Записи не содержат числа продаж и отзывов. | shop | seller, sort, user_id | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 20. | $1.39 за 1 000 запросов | id · url · title · original_price · currency · category_id · free_shipping · shop_name · shop_id · seller_id · image_url · shop_url · shop_logo_url · shop_score_description · shop_score_service · shop_score_delivery · shop_item_count · platform |
reviewsОтзывы Получите отзывы покупателей о товаре Taobao. У каждого отзыва есть оценка, купленный вариант, голоса «полезно», фото, дополнительный отзыв и ответ продавца. Передайте ID товара, ссылку на товар или текст «Поделиться» с одной ссылкой на товар. Пакет может включать не все отзывы. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · text · rating · rating_scale · posted_at · sku · buy_count · useful_count · author_name · author_avatar_url · images · review_append · platform · seller_reply |
questionsВопросы Получите вопросы покупателей и ответы на странице товара Taobao с числом ответов и датой публикации каждого вопроса. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · answer_count · posted_at · answers · platform |
Что означают параметры действия search в API Taobao?
Ищите карточки товаров на Taobao и Tmall по ключевому слову: цена и место отправки, а также число продаж, рейтинг, магазин и купоны или скидки, если они есть. Простой поиск по ключевому слову надёжнее всего и поддерживает пагинацию через page, по 20 записей на страницу, хотя в большинстве записей нет числа продаж и названия магазина. Пагинация недоступна при использовании диапазона цен, popular, price_desc или tmall_only, а при последних трёх вариантах за запрос возвращается не более 10 записей. Наличие, подлинность и доставка не подтверждаются.
keywordОбязательный- Поисковый запрос для поиска товаров на Taobao или Tmall в действии search. Точный поиск по названию магазина не выполняется.
max_priceНеобязательный- Максимальная цена товара для действия search, задаётся вместе с min_price. Не управляет лимитами остатков SKU. Дробные значения могут округляться вверх до целого. Поиск с диапазоном цен не поддерживает пагинацию.
min_priceНеобязательный- Минимальная цена товара для действия search. Это не фильтр по оценке в отзывах и не параметр стоимости API; к shop, product_detail, reviews и questions он не применяется. Дробные значения могут округляться вниз до целого. Поиск с диапазоном цен не поддерживает пагинацию.
pageНеобязательный- Номер страницы при поиске товаров: от 1 до 50, по 20 результатов на странице. Для страницы 1 параметр можно не указывать; каждая страница оплачивается как один вызов. Пагинация доступна только для простого поиска по ключевому слову (без min_price, max_price и tmall_only, а sort не указан или равен relevance). Такой поиск надёжнее, хотя у большинства записей нет данных о продажах и названия магазина. Запрос со страницей больше 1 и любым из этих фильтров отклоняется до списания средств, поэтому для пагинации уберите эти фильтры. limit задаёт только количество результатов на этой странице, поэтому при пагинации оставляйте его равным 20. Ранжирование обновляется в реальном времени, поэтому на соседних страницах иногда повторяются несколько товаров; при объединении страниц удаляйте дубликаты по id.
sortНеобязательный- Для поиска товаров используйте relevance (по умолчанию), popular или price_desc. При сортировке по умолчанию и relevance доступно до 20 результатов, при popular и price_desc до 10, без пагинации. Запросы сверх соответствующего лимита отклоняются до списания средств; price_asc не поддерживается. Reviews и questions не принимают sort. Shop принимает его без ошибки, но пока он ни на что не влияет.Допустимые значения:
popularprice_descrelevance tmall_onlyНеобязательный- При логическом значении true оставляет в поиске только товары Tmall и ограничивает запрос 10 результатами без пагинации. Передавайте только логическое значение JSON: строки вроде "false" и запросы сверх этого лимита отклоняются до списания средств.
Что означают параметры действия product_detail в API Taobao?
Получите полную запись о товаре Taobao или Tmall: бренд, цены, остаток, все SKU, атрибуты, изображения, стоимость доставки и оценки магазина. Передайте числовой ID товара, ссылку на товар или текст «Поделиться» ровно с одной ссылкой на товар. Коды «Поделиться» без ссылки и устаревшие ссылки отклоняются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара. Ссылки e.tb.cn и m.tb.cn работают, только если их можно безопасно развернуть до страницы товара. Токены TaoPassword без ссылки, устаревшие ссылки и страницы, не относящиеся к товарам, отклоняются.Taobao: что такое ID товара и SKU — Taobao определяет ID товара как цифры после id= в ссылке на товар, а SKU — как конкретную комбинацию атрибутов, например цвета и размера. ID товара и SKU нельзя использовать взаимозаменяемо. · Проверено
Что означают параметры действия shop в API Taobao?
Получите до 20 товаров, которые продавец Taobao продаёт сейчас: зачёркнутую цену, категорию, флаг «доставка включена», основное изображение и оценки магазина. Записи не содержат числа продаж и отзывов. shop принимает числовой ID пользователя-продавца или ссылку на магазин, а не название магазина.
shopОбязательный- Числовой userId продавца (sellerId) или ссылка на магазин (shop<shopId>.taobao.com) для действия shop. Возвращает товары, которые продаёт этот продавец, не более 20 за запрос: если limit больше 20, всё равно возвращаются 20 товаров по той же цене за вызов API. Это не название магазина.
sellerНеобязательный- Запасной параметр совместимости для числового userId продавца в действии shop. Принимает только числовые ID пользователей, а не никнеймы продавцов. Приоритет ниже, чем у shop и user_id.
sortНеобязательный- Для поиска товаров используйте relevance (по умолчанию), popular или price_desc. При сортировке по умолчанию и relevance доступно до 20 результатов, при popular и price_desc до 10, без пагинации. Запросы сверх соответствующего лимита отклоняются до списания средств; price_asc не поддерживается. Reviews и questions не принимают sort. Shop принимает его без ошибки, но пока он ни на что не влияет.Допустимые значения:
best_sellinghighest_pricelowest_pricenewnewly_listedpopularprice_ascprice_descsales user_idНеобязательный- Запасной параметр совместимости для числового userId продавца в действии shop. Приоритет ниже, чем у shop; использовать его как ID товара нельзя.
Что означают параметры действия reviews в API Taobao?
Получите отзывы покупателей о товаре Taobao. У каждого отзыва есть оценка, купленный вариант, голоса «полезно», фото, дополнительный отзыв и ответ продавца. Передайте ID товара, ссылку на товар или текст «Поделиться» с одной ссылкой на товар. Пакет может включать не все отзывы.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара. Ссылки e.tb.cn и m.tb.cn работают, только если их можно безопасно развернуть до страницы товара. Токены TaoPassword без ссылки, устаревшие ссылки и страницы, не относящиеся к товарам, отклоняются.Taobao: что такое ID товара и SKU — Taobao определяет ID товара как цифры после id= в ссылке на товар, а SKU — как конкретную комбинацию атрибутов, например цвета и размера. ID товара и SKU нельзя использовать взаимозаменяемо. · Проверено
Что означают параметры действия questions в API Taobao?
Получите вопросы покупателей и ответы на странице товара Taobao с числом ответов и датой публикации каждого вопроса. answer_count может отличаться от числа возвращённых ответов, и ответы не обязательно даны продавцом.
urlОбязательный- Для product_detail, reviews или questions передайте числовой ID товара, URL товара Taobao/Tmall или текст из «Поделиться», содержащий ровно один URL товара. Ссылки e.tb.cn и m.tb.cn работают, только если их можно безопасно развернуть до страницы товара. Токены TaoPassword без ссылки, устаревшие ссылки и страницы, не относящиеся к товарам, отклоняются.Taobao: что такое ID товара и SKU — Taobao определяет ID товара как цифры после id= в ссылке на товар, а SKU — как конкретную комбинацию атрибутов, например цвета и размера. ID товара и SKU нельзя использовать взаимозаменяемо. · Проверено
Как использовать API Taobao
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"taobao","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Taobao
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Монетизация парсинга цен: как построить продукт мониторинга цен, который продавцы будут продлевать
Почему продавцы платят за мониторинг цен и почему отменяют подписку. Разбираем способы поставки ценовых данных, единицы тарификации и приёмку пилота через сопоставление товаров, списки исключений и процессы согласования цен.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюСбои API, возврат кредитов и сверка: как проверить чистое списание за запрос
Разделяйте задачи, попытки вызова, состояния доставки и события кошелька, чтобы без двойного учёта обрабатывать отказы до списания, пустые результаты и частичный возврат кредитов; офлайн-примеры построены на целых числах.
Читать статьюВопросы об API Taobao
Какие данные можно получить через API Taobao?
Укажите в platform значение taobao. В текущем каталоге: поиск, сведения о товаре, магазин, отзывы и вопросы. Эти названия действий соответствуют разным объектам или представлениям Taobao; это не взаимозаменяемые режимы поиска.
Есть ли у Taobao официальный API?
Taobao Open Platform предназначена для разработчиков ПО, сервисных партнёров и брендов, которые создают инструменты для продавцов Taobao и Tmall. Данные магазина, например товары и заказы, читаются с токеном доступа, который продавец выдаёт при авторизации приложения, а приложениям для покупателей вместо этого доступны партнёрские товарные API Taobao (Taobaoke).
Официальные источники: «Taobao Open Platform: introduction» · «Taobao Open Platform: integration guide» · Проверено
Нужен ли аккаунт разработчика Taobao или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Taobao, запрашивать доступ к API Taobao или входить через аккаунт Taobao. Действия возвращают только публичные данные Taobao.
Сколько стоит Taobao API за 1 000 запросов?
От $1.39 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе Taobao?
Поисковый запрос для поиска товаров на Taobao или Tmall в действии search. Точный поиск по названию магазина не выполняется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Taobao?
Объявленная схема включает title, price, currency и sold_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Taobao возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.