Доступность платформы
- Состояние за 24 ч
- 98%
За последние 30 дней
Доступные возможности
Все действия Shopee: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите товары на маркетплейсе Shopee по ключевому слову: цена, исходная цена и скидка, рейтинг, число продаж, местоположение продавца и флаг Shopee Mall. | $6.4 за 1 000 запросов | Работает стабильно · состояние 100% |
Данные товараprofile | Откройте страницу товара Shopee по полному url: описание, диапазон цен по вариантам, остаток, число продаж, лайки, бренд и статус предзаказа. | $1.39 за 1 000 запросов | Работает стабильно · состояние 98% |
Магазинshop | Просматривайте товары магазина Shopee по имени пользователя или числовому ID: цена, скидка, рейтинг, число продаж и статус Mall для каждой карточки товара. | $1.39 за 1 000 запросов | Норма |
Сведения о товареproduct_detail | Получите полную карточку товара Shopee по ссылке на товар: описание, варианты, текст скидки, остаток, число продаж, отзывы, а также название и местоположение магазина. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Shopee?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите товары на маркетплейсе Shopee по ключевому слову: цена, исходная цена и скидка, рейтинг, число продаж, местоположение продавца и флаг Shopee Mall. По умолчанию в | keyword | country, max_price, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $6.4 за 1 000 запросов | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
profileДанные товара Откройте страницу товара Shopee по полному | url | country | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | shop_id · item_id · name · url · description · price · price_min · price_max · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · stock · liked_count · view_count · brand · is_pre_order · has_video · platform · images · shop |
shopМагазин Просматривайте товары магазина Shopee по имени пользователя или числовому ID: цена, скидка, рейтинг, число продаж и статус Mall для каждой карточки товара. Отзывы о магазине, финансы и закрытые заказы не включаются, полнота каталога не гарантируется. | shop | country | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
product_detailСведения о товаре Получите полную карточку товара Shopee по ссылке на товар: описание, варианты, текст скидки, остаток, число продаж, отзывы, а также название и местоположение магазина. У каждого рынка своя валюта, поэтому читайте | url | country | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · price · original_price · currency · discount · stock · sold_count · rating · rating_scale · review_count · shop_name · shop_location · variants · image_url · platform |
Что означают параметры действия search в API Shopee?
Ищите товары на маркетплейсе Shopee по ключевому слову: цена, исходная цена и скидка, рейтинг, число продаж, местоположение продавца и флаг Shopee Mall. По умолчанию в country выбрана Индонезия, а фильтры по цене используют валюту этого рынка.
keywordОбязательный- Ключевые слова для поиска товаров в
search. Региональный маркетплейс определяется параметромcountry. countryНеобязательный- Код региона; имеет приоритет над
regionи определением по URL. Дляsearch,profileиshopпо умолчанию используетсяid(Индонезия). Распознаются доменыsg,my,th,ph,vn,br,tw,mx,coиcl, но распознанный домен не гарантирует наличие данных для каждого региона.product_detailобычно берёт регион из URL товара.Допустимые значения:brclcoidmxmyphsgthtwvn max_priceНеобязательный- Максимальная цена товара в ценовой шкале целевого маркетплейса. Используйте вместе с min_price, чтобы задать диапазон. Фильтр работает с целыми числами: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Минимальная цена товара для
searchв валюте целевого рынка. Не рассчитывайте, что в разных регионах значения выражены в одной валюте. Параметр не связан с суммами оплаты API. Фильтр работает с целыми числами: дробные значения округляются вниз (39.81 становится 39). sortНеобязательный- Сортирует результаты поиска товаров в
search. Допустимые значения:relevance,popular(по продажам),newest,price_ascиprice_desc. Не используется для списков товаровshopи данных о товаре.Допустимые значения:newestpopularprice_ascprice_descrelevance
Что означают параметры действия profile в API Shopee?
Откройте страницу товара Shopee по полному url: описание, диапазон цен по вариантам, остаток, число продаж, лайки, бренд и статус предзаказа. Несмотря на название, это действие описывает товар, а не покупателя или продавца. Сокращённые ссылки сначала разверните до конечной страницы.
urlОбязательный- Полный URL товара Shopee для
profileиproduct_detail.profileизвлекает идентификаторы по шаблонуi.shop_id.product_id. Короткие ссылки сначала нужно развернуть до URL конечной страницы, их прямой разбор не гарантируется.Shopee: где найти Shop ID и Item ID — Обучающие материалы Shopee для продавцов разделяют Shop ID, Item ID, имя пользователя и отображаемое название магазина и предупреждают, что эти идентификаторы нельзя путать. Здесь эти термины приводятся без гарантии, что действия в панели продавца в других регионах будут такими же. · Проверено countryНеобязательный- Код региона; имеет приоритет над
regionи определением по URL. Дляsearch,profileиshopпо умолчанию используетсяid(Индонезия). Распознаются доменыsg,my,th,ph,vn,br,tw,mx,coиcl, но распознанный домен не гарантирует наличие данных для каждого региона.product_detailобычно берёт регион из URL товара.Допустимые значения:brclcoidmxmyphsgthtwvn
Что означают параметры действия shop в API Shopee?
Просматривайте товары магазина Shopee по имени пользователя или числовому ID: цена, скидка, рейтинг, число продаж и статус Mall для каждой карточки товара. Отзывы о магазине, финансы и закрытые заказы не включаются, полнота каталога не гарантируется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеshopОбязательный- Имя пользователя магазина или числовой ID магазина (с префиксом
@или без него) дляshop. Возвращает список товаров магазина, а не отзывы о магазине.Shopee: чем имя пользователя отличается от отображаемого названия магазина — Shopee описывает имя пользователя для входа отдельно от Shop Name, которое видят покупатели. Отображаемое название магазина может содержать пробелы и не может напрямую заменять имя пользователя или Shop ID, которые требуются в этом параметре. · Проверено countryНеобязательный- Код региона; имеет приоритет над
regionи определением по URL. Дляsearch,profileиshopпо умолчанию используетсяid(Индонезия). Распознаются доменыsg,my,th,ph,vn,br,tw,mx,coиcl, но распознанный домен не гарантирует наличие данных для каждого региона.product_detailобычно берёт регион из URL товара.Допустимые значения:brclcoidmxmyphsgthtwvn
Что означают параметры действия product_detail в API Shopee?
Получите полную карточку товара Shopee по ссылке на товар: описание, варианты, текст скидки, остаток, число продаж, отзывы, а также название и местоположение магазина. У каждого рынка своя валюта, поэтому читайте price вместе с currency. Отображаемый остаток не подтверждает реальное наличие.
urlОбязательный- Полный URL товара Shopee для
profileиproduct_detail.profileизвлекает идентификаторы по шаблонуi.shop_id.product_id. Короткие ссылки сначала нужно развернуть до URL конечной страницы, их прямой разбор не гарантируется. countryНеобязательный- Код региона; имеет приоритет над
regionи определением по URL. Дляsearch,profileиshopпо умолчанию используетсяid(Индонезия). Распознаются доменыsg,my,th,ph,vn,br,tw,mx,coиcl, но распознанный домен не гарантирует наличие данных для каждого региона.product_detailобычно берёт регион из URL товара.Допустимые значения:bridmxmyphsgthvn
Как использовать API Shopee
- 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":"shopee","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Shopee
Какие данные можно получить через API Shopee?
Укажите в platform значение shopee. В текущем каталоге: поиск, данные товара, магазин и сведения о товаре. Эти названия действий соответствуют разным объектам или представлениям Shopee; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Shopee?
Ключевые слова для поиска товаров в search. Региональный маркетплейс определяется параметром country. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Shopee?
Объявленная схема включает shop_id, item_id, name и image_url. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Shopee возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.